ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý[CFDL]Þ±±° ù Custom File Directory Lister PPE (c)1994-95 ù °±±Ý[CFDL]Þ±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ úúúúúù Custom File Directory Lister ùúúúúúúú ³ Author: Robert Hunter ³Ý Þ³ úúúúúúúúù Version: 1.00 Standard ùúúúúúúúúúú ³ a.k.a: Midnight Slasher ³Ý Þ³ úúúúúúúúúúúúúúù [12/20/94] ùúúúúúúúúúúúúúúúú ³ E-Mail: mslasher@io.org ³Ý ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ CONTENTS ³ 1. Files Included 5. General Program Information ³Ý Þ³ OF ³ 2. Brief Program Summary 6. Distribution ³Ý Þ³ DOCUMENTATION ³ 3. Installation 7. Legal-ese ³Ý Þ³ ³ 4. External Files 8. Registration (Please Read) ³Ý ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý FILES INCLUDED Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ CFDL.DOC .... 17,308 .. Documentation / Installation Guide (Please Read) Þ³ CFDL.PPE .... 14,603 .. File Directory Lister PPE Þ³ _CFDL.COL ....... 828 .. Color Configuration File (Optional) Þ³ _CFDL.GRP ....... 312 .. Categories Grouping File (Optional) Þ³ _CFDL.PMT ....... 859 .. Prompt Configuration File (Optional) Þ³ FILE_ID.DIZ ..... 462 .. Description Identification File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý BRIEF PROGRAM SUMMARY Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A .PPE (* PCBoard Programming Language Executable *) for PCBoard v15.2+ BBS. This program can be used as a replacement for your "F" command. It will dynamically create a listing for the current conference of the available file directories. It allows grouping of specific directories into categories via a group file. During display, a command line display or a fully INTERACTIVE view can be used (use cursor keys). Specific directories can also be TAGGED for viewing or for other directory commands. It can be a very powerful directory viewer, helpful to those systems that have a lot of directories, those systems that wish to group directories into categories, and for the other lazy system operators like me. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý INSTALLATION Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 1. Load PCBSETUP 2. Press B ( File Locations ) 3. Press B ( Configuration Files ) 4. Edit CMD.LST ( Press F2 at the CMD.LST File ) Example CMD.LST: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Charges Per ³ ³ Command Sec Minute Use PPE/MNU/Keystroke Replacement ³ ³ ÍÍÍÍÍÍÍÍÍ ÍÍÍ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ³ ³ F # 0 0 DRIVE:\PATH\CFDL.PPE ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 5. Rename and edit any _CFDL.* file(s) to CFDL.* _only_ if you wish to use optional configuration or color preferences. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý EXTERNAL FILES Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Packaging Note: You may notice that many files come packaged as _FILE.EXT . This is because they are optional files. They will not be used unless you rename them to FILE.EXT (remove the _). It is packaged this way to prevent users who want to use the defaults provided in the program from using these files unintentionally, which simply slows down the loading process. ----------------------------------------------------------------- CFDL.COL : The Color Configuration File. This file allows you to change any or all of the colors used in the program. If you wish to use the default colors, do not use this file.Its theoretically faster to load the program if no CFDL.COL file is found and defaults are automatically used. Instructions are contained within this file. ----------------------------------------------------------------- CFDL.GRP : The Grouping File. Further explanation in "General Program Info" ----------------------------------------------------------------- CFDL.PMT : The Prompt Configuration File. This file allows you to configure the prompts that are used in the program. It also allows you to define what the 'Upload Directory' will be called. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý GENERAL PROGRAM INFORMATION Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 1. Grouping Directories / Categories ----------------------------------------------------------------------------- When the program loads, it first looks to see if you have a .GRP file. This file defines any categories you wish to use, and what file directories are linked to what categories. An example CFDL.GRP file might look like: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ALL Available File Directories in this Conference ³ ³ A ³ ³ Windows Specific Software ³ ³ 1;2;3;4;5-33 ³ ³ OS/2 Specific Software ³ ³ 34-66;100 ³ ³ DOS Based Miscellaneous Utilities ³ ³ 67-99 ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The file format is: Line 1: Description of category Line 2: Directories to include in categories (colons separate numbers, ranges (ie: 1-25) are valid) (Up to 19 descriptions/categories in this version, per group file) * If the special character "A" is listed in a Directories to Include Line all directories will be listed. * If uploads are public, the uploads directory will ALWAYS be listed in each category. This makes it easy to find since the upload directory usually doesn't belong in one specific category; it is a mixture of miscellaneous files. (If uploads are private, no upload directory will be displayed) ----------------------------------------------------------------------------- Since different conferences can have different file directories, you may wish to group each conference with file directories in a different way. To do this simply create a CFDL[Conference Number].GRP file for each specific conference. CFDL.GRP will always be the default. For example, if a user is in conference 25, CFDL will first look for and use CFDL25.GRP for its conference grouping list. If CFDL25.GRP can't be found, CFDL.GRP will be used instead. If there is no CFDL.GRP, CFDL will simply continue to list ALL the available file directories with no group list. ----------------------------------------------------------------------------- When and if a category list is displayed, the user can either select a category by typing the appropriate corresponding letter at the standard input prompt, or they can press [TAB] to enter Interactive Mode and scroll through the categories. They can then press [ENTER] when they have hi-lighted the wanted category. 2. File Directory Listing / Standard or Interactive Mode ----------------------------------------------------------------------------- When the File Directory Listing is being displayed, the user can press [TAB] to toggle between interactive and standard input prompt mode. Interactive mode will only work if the user supports ANSI graphics. In standard prompt mode, the user can select a directory to be displayed by entering the number. They can also perform any and all the standard File Prompt commands that are supported by PCBoard. If the directory listing is multiple pages long, pressing [ENTER] at the prompt will continue to scroll through the directories. At the last page, pressing [ENTER] will return to the main prompt, just like a standard directory listing. Furthermore, if the listing is multiple pages, the user can press "-" to return to a previous page. In interactive mode, the user can scroll through all the directories with the cursor keys, and the PGUP/PGDN keys to switch pages. The user can press the [ENTER] key when on a high-lighted directory to view that specific directory. The user can also press [SPACE] to toggle directories to be viewed. For example, if the user was in interactive mode, and pressed the [SPACE] key when on directories 1, 2 and 4, directories 1, 2 and 4 would be displayed when the user hit the [ENTER] key. A combination of standard prompt mode and interactive mode can also be used, making a potentially very powerful tool for scanning directories. The best way to explain this is by example: When in standard prompt mode, a user can type the letter 'z'. The user can then press the [TAB] key to enter Interactive Mode. When in interactive mode the user can select specific directories (with the space bar). Lets say the user presses the [SPACE] key when on directories 1,2,5,8,10,12 and 15. The user then presses [ENTER]. By doing so, the user has basically started a ZIPPY text scan for those specific directories. PCBoard will prompt the user for the text to scan for and start the scanning process. This type of combination usage can be used with the L and N commands as well! It makes selecting directories to scan very easy when it is done interactively with a scroll bar and cursor keys. 3. Miscellaneous ----------------------------------------------------------------------------- The Colour (.COL) and Prompt (.PMT) configuration files can also be made conference specific, ie: CFDL[Conference Number].COL (ie: CFDL500.COL for conf 500) CFDL[Conference Number].PMT (ie: CFDL10.PMT for conf 10) to change the look and feel of the program in specific conferences. CFDL works for Color/NoColor ANSI and CTTY users. Memory usage is directly related to the number of available file directories. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý DISTRIBUTION Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You are always welcome to send Internet E-Mail requesting program info, ask any questions you may have, or to request a UUEncoded copy of any supported program (that is what that specific account is for!), or: "FINGER -l mslasher@io.org" anytime via your internet accessible account to view up-to-date information about: þ Program information concerning the latest released version .............. þ þ Directions to official distribution site(s) ............................. þ þ A list of other supported programs ...................................... þ þ Other miscellaneous information ......................................... þ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý LEGAL-ESE Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ USAGE OF THIS SOFTWARE INDICATES YOUR ACCEPTANCE OF THE SOFTWARE LICENSE TERMS ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This software is the property of the authors, Robert Hunter / G.L., the registered copyright owners. They only license the software's use, public distribution does not transfer ownership of this copy.In addition, you assume responsibility for the selection of the software to achieve your intended results and for the installation, use and results obtained from the software. This license is effective until terminated. You may terminate it at any time by destroying the software together with all copies. You agree upon such termination to destroy the software together with all copies. Among other things, you may not: rent, lease, modify, translate, disassemble, decompile, reverse engineer, or create derivative works based upon the software. If you fail to comply with any terms of this license agreement, your license is automatically terminated. This license will be governed by the author's residential provincial or state laws except as to copyright and other proprietary matters which may be preempted by federal laws and international treaties. In the event of any dispute involving this license, the Licensee consents to exclusive jurisdiction and venue in either the authors residential provincial/state or federal courts and agrees that the prevailing party shall be entitled to its attorney fees and costs. In the event any provision of this license shall be deemed unenforceable, void, or invalid, such provision shall be modified so as to make it valid & enforceable and as so modified the entire agreement shall remain in full force and effect. No decision, action or inaction by the author(s) shall be construed to be a waiver of any rights or remedies available to them. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BY USING OR BEING IN POSSESSION OF THIS SOFTWARE YOU ACKNOWLEDGE THAT YOU HAVE READ, UNDERSTOOD, AND AGREE TO BE BOUND BY THIS AGREEMENT'S TERMS & CONDITIONS. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý REGISTRATION / AUTHOR NOTES Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ We understand that software license enforcement is far from easy; copyright violations are much easier to report to the proper authorities. We also understand that the segment of persons that might be interested in this software is not one that enjoys paying for every utility (simple or not) that they deem useful. This software is not limited/crippled from standard usage in any way. If you use this software for an extended period of time (thirty or more days) registration is required. As you have most likely read many times before, much work, time and effort is put into producing software. We wish to be able to continue to support this software's development and the persons that use this software. Please send electronic mail (Internet Email) to the support account acknowledging your use of this software, and an address to send registration funds will be sent in reply. If you simply can not afford to part with a nominal registration fee, or simply do not feel the software is worth monetary registration, please at least acknowledge its usage so we know our efforts are not wasted. Either way, we do hope you find this software useful. Since we release uncrippled software, we can only hope the software is used and enjoyed, and those persons that can understand and appreciate the shareware concept can find the time to recognize the work that has gone into producing this package. -- Thank you. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ úúúù Contacting the Author Via Internet E-Mail: ùúúúú ³Ý ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±Ý Þ±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ