+-----------------------------------------------------------------------------+ | Enhanced Flag v2.2 | | Written by Drew [PWA] | | Docs Last Updated 05-10-95 | +-----------------------------------------------------------------------------+ +-----------------------------------------------------------------------------+ | 0. Table of Contents | +-----------------------------------------------------------------------------+ 1. Introduction 2. Packaging 3. Installation 4. Configuration 5. General Notes 6. Supporting PPE's 7. Last Words +-----------------------------------------------------------------------------+ | 1. Introduction | +-----------------------------------------------------------------------------+ See HISTORY.DOC for all changes. Otherwise... Enhanced Flag is a PPE replacement for the "More?" prompt during a file listing. It gives you an easier to method of flagging files for downloading, viewing, nuking, et. al. by using a lightbar and hotkey driven interface, in- cluding all of the arrow keys. Additionally, through the usage of configuration files, EFLAG can spawn custom external commands (other PPE's) in addition to or replacing any or all of the built-in commands. This PPE was written in PPL 3.0 for PCBoard 15.2+ only. +-----------------------------------------------------------------------------+ | 2. Packaging | +-----------------------------------------------------------------------------+ Your zip file should contain the following files: EFLAG CFG Main EFLAG configuration file EFLAG DOC EFLAG Documentation (you are reading it now) EFLAG HLP EFLAG help screen EFLAG PPE The actual PPE EXTERNAL ZIP Sample front-end ppe's to use HISTORY DOC History/revision document INSTALL BAT Installation batch file PROMPT1 CFG Configuration file for Prompt #1 PROMPT2 CFG Configuration file for Prompt #2 YESNO CFG Configuration file for yes/no prompt OTHERDJP DOC Other stuff I've written. FILE_ID DIZ File (zip) description. PWA NFO PWA info file. TSP NFO My bbs ad. If any of these files are missing, be warned that you may have a copy that has been tampered with. If you have any extra files, they are extraneous and unnecessary. Typically, my bbs ad may not be there, which is not a problem. However, the idiots who contribute this to the fidonet backbone (usually originating from the Clipper Workshop BBS) edit the FILE_ID.DIZ, remove PWA.NFO and OTHERDJP.DOC, and insert their own bbs ad which is bigger than most ppe's. Just be aware, since who knows what other stupidities they may pull. +-----------------------------------------------------------------------------+ | 3. Installation | +-----------------------------------------------------------------------------+ Simply unzip the original zip file into its own directory and run the INSTALL.BAT file. It will automatically tell you the syntax needed to install EFLAG. For manual installation, run MKPCBTXT to edit your PCBTEXT file, and have Prompt #549 point to this ppe. Ie: !C:\PPE\EFLAG\EFLAG.PPE If you are upgrading from EFLAG v1.0, you must REINSTALL the entire thing because EFLAG v2.0 has been completely redone and everything is different. +-----------------------------------------------------------------------------+ | 4. Configuration | +-----------------------------------------------------------------------------+ There are three configuration files, all of which are optional. Default values will be used in the lack of presence of these configuration files, but the colours will most like clash with your boards colour scheme. :) The configuration files are as follows: EFLAG.CFG : Eflag behaviour-type options; only 4 lines long. :) PROMPT1.CFG : Configure the look, feel, and commands for Prompt #1. PROMPT2.CFG : Configure the look, feel, and commands for Prompt #2. All config files are well-documented inside and should be fairly straight forward. None of them are heinously long or complex, unless you choose it to be. :) In v2.2, a new configuration file, "YESNO.CFG" is added. This is used to ask the user is they are sure they want to display the file listing in nonstop mode. This feature was added because some users may accidentally select nonstop mode and do not realize ctrl-k/x aborts the humongous file listing. :) If you do not want this feature enabled, simply delete (or rename) this config file. +-----------------------------------------------------------------------------+ | 5. General Notes | +-----------------------------------------------------------------------------+ After v1.0 of EFLAG, which was released back in August 1994, I made some minor changes/additions/modifications. Some were minor "bug" fixes, which were mostly small details in packaging, and did not affect the actual usage of EFLAG. A few new features were added as well to make EFLAG even more useful. However, since that time, PPL 3.0 and PCBoard 15.2 was released and the continuation of writing more sloppy code in PPL 2.0 seemed moot. Hence, after an extremely busy few months dealing with many many things at once, EFLAG 2.0 was completely rewritten in PPL 3.0 and reincarnated. If you would like your prompts, pathnames, et. al. hard-coded into the program for fastest execution speed possible (thus removing the need for all the config files), feel free to let me know. I will need a copy of all the config files. See below on how to contact me. +-----------------------------------------------------------------------------+ | 6. Supporting PPE's | +-----------------------------------------------------------------------------+ EFLAG has been personally tested by me to work with the following PPE's fully with no problem: o PWA FileView v2.5 o SCuM-NuKeR v1.0/1.1 o BlackCat's File Viewer v1.0, v2.0, v2.1 o BlackCat's Nuker v0.81b, v0.82b Included is EXTERNAL.ZIP which includes some front-end ppe's for usage with EFLAG to allow EFLAG to execute some the above ppe's seamlessly. Take a look inside there for examples, instructions, and details. If you have a particu- lar PPE that you wish to interface with EFLAG, feel free to drop me a note if you need help. +-----------------------------------------------------------------------------+ | 7. Last Words | +-----------------------------------------------------------------------------+ (Bitch-mode on.) I've had a flood of requests for a bunch of my source code. Some because they just want to have it, others even going so much as to say something to the sense of, "With a name like Pirates With Attitudes, I'm obligated to check for backdoors before running the PPE on my system." I'm fed up with this. I've never included a backdoor in any of my work and am not about to start. My current policy for distribution of source code is that I'm only giving it to people who are going to make a significant amount of modifications to it (and I'll be the one who deems what is signi- ficant or not). I know this sounds harsh, but hey, that's life. At least I still make my source available. If you need to learn how to program, then go buy a book, go to school, get the manual, or a combination thereof. If that's not it and you just don't like the PPE, then don't use it. (Bitch-mode off.) Many thanks to those who have actually given me constructive criticism, suggestions, et al. Most of you sent me internet email, so you know who you are. :) Otherwise, if you need to reach me for some reason, you can send internet email to "drew@xinet.com", or leave me a message on Attitude Net, or call my board: The Silicon Phalanx at 310-575-8567 and apply for access. Peace, --Drew