+-----------------------------------------------------------------------------+ | Enhanced Flag v2.21 | | Written by Drew [PWA] | | Docs Last Updated 11-15-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. As of v2.21, this PPE was written in PPL 3.10 for PCBoard 15.21+ only. +-----------------------------------------------------------------------------+ | 2. Packaging | +-----------------------------------------------------------------------------+ Your zip file should contain the following files: 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 PR1CFG Config file for Prompt #1 (language aware) PR2CFG Config file for Prompt #2 (language aware) YESNOCFG Config file for yes/no prompt (language aware) _EFLAG CFG Optional EFLAG config file (formerly main config) 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 with parameters as described below: !C:\PPE\EFLAG\EFLAG.PPE @X4F 79 yes no 1 @X0F* Param 1: Lightbar color when highlighting a file Param 2: Length (width) of lightbar Param 3: Use hotkeys, "yes" or "no" Param 4: Use spacebar to highlight a file, "yes" or "no" Param 5: Delay time (in clock ticks) between keyboard polls Param 6: Color and character for tagged files to be flagged 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. If you are upgrading from v2.2, it is highly suggested that you use the parameter method of installing EFLAG instead of using the old configuration file (EFLAG.CFG). Using the parameters speeds up initial loading and removes the need for EFLAG.CFG. You may still use the config file, but you will need to update it with the correct options. Refer to "_EFLAG.CFG" for an example. +-----------------------------------------------------------------------------+ | 4. Configuration | +-----------------------------------------------------------------------------+ There are two 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 likely clash with your boards colour scheme. :) The configuration files are as follows: PR1CFG : Configure the look, feel, and commands for Prompt #1. PR2CFG : Configure the look, feel, and commands for Prompt #2. Both 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 if 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. ** NOTE! ** v2.21 and up requires PCBoard v15.21 or higher, not 15.2! In v2.21, the need for EFLAG.CFG has been removed. See the previous section (Installation) for details. +-----------------------------------------------------------------------------+ | 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, v2.2 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 | +-----------------------------------------------------------------------------+ if you need to reach me for some reason, you can send internet email to "drew@topaz.com", or leave me a message on Attitude Net. Peace, --Drew