旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커 � Reality's Edge Creations: FLAG+ v2.00 Documentation 넴 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸� 賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽賽 What is FLAG+? ======================================== FLAG+ is a replacement for PCBoard's internal directory listing prompt. This utility allows your callers to quickly and efficiently browse through large file listings while selecting files for later downloading, viewing, etc. with ease. Disclaimer ======================================== This program and other files associated with it are not guaranteed to be bug free or virus free. We are not responsible for any damages of any kind, including profit loses and data loss, that relate directly or indirectly to these programs and files. You may distribute this program, as long as it is unmodified for with all the files originally included. This program is SHAREWARE; meaning you have 30 days to evaluate it. After your trial period has expired, you are required to register it or completely destroy it. Please support the shareware concept to encourage authors to continue writing programs and reducing the costs. Files Included ======================================== FILE_ID.DIZ Description file, used by BBS INSTALL.BAT Installation batch file INSTALL.DAT Archive containing program files � 쳐 BUGS.!!! Known bugs (If any) relating to FLAG+ 쳐 DNLOAD?.* Displayed before downloading 쳐 DOWNLOAD.PPE Sample download program 쳐 DOWNLOAD.PPS Source code for DOWNLOAD.PPE 쳐 FLAGPLUS.CFG Configuration file 쳐 FLAGPLUS.DOC Documentation for FLAG+ 쳐 FLAGPLUS.HIS FLAG+ programming history 쳐 FLAGPLUS.PPE Main program, use STARTUP.PPE to execute 쳐 HELP?.* Online help file 쳐 PREFILER.* RIP interface for selecting files 쳐 PROMPTS.* Prompt configuration file(s) 쳐 REGISTER.FRM Registration form 쳐 STARTUP.PPE Used to load FLAGPLUS.PPE 쳐 TEST?.* Displayed before testing a file 쳐 VIEWARCS.PPE Sample file viewing program 쳐 VIEWARCS.PPS Source code to VIEWARCS.PPE 읕 VIEW?.* Displayed before viewing a file Quick Start ======================================== Strait forward: 1. Run the INSTALL file included with this archive. 2. Edit *EVERY* directory heading so there is the clear screen code, @CLS@, before any text. This will fix the problem where the first page would be offset several lines (RIPscrip graphics). 3. Edit the FLAGPLUS.CFG file to fit your needs (See next section - Configuration). Notes: The INSTALL file will copy the PREFILER file to your CMDFILES directory which will be displayed before the directory listing. This is the file which displays the RIPscrip interface, please see the PREFILER.* section for details. Prompt #549 in the PCBTEXT file is modified by INSTALL. Configuration ======================================== FLAGPLUS.CFG: Line 1: Registration number (if registered). Line 2: Minimum baud rate to use FLAG+, slower bauds will use PCBoard's standard prompt. Line 3: Path to RAM disk/work directory. This file is used to resume PPE control after flagging files and is approximately 40 bytes per node. -This path may be the same for all nodes. Line 4: Name + location of 3rd-party viewing program, leave blank to disable. Starting with version v2.00, FLAG+ will ONLY support PPE's; meaning you'll need to make a PPE to run an EXE/COM/BAT program. Note, the file name and type (extension) are passed via the Tokenize statement, to retrieve these values use the GetToken function/statement. A sample has been included. Line 5: Name + location of 3rd-party archive tester, leave blank to disable. PPE support ONLY - See line 4. Line 6: Name + location of 3rd-party downloader, leave blank to disable. PPE support ONLY - See line 4. Line 7: @X color code of file names. This should be the same color as setup in PCBFiler. (Example: @X0E - bright yellow on black) Line 8: @X color code of a selected/highlighted file. Line 9: @X color code of a flagged file. Line 10: @X color code of a selected/highlighted + flagged file. Line 11: Character to begin sending RIP mouse coordinates. (See next section) PROMPTS.*: Line 1: Normal prompt, displayed to non-ansi/color callers Line 2: Ansi prompt Line 3: RIP prompt (should generally be left blank) PREFILER.(Language Extension) Files ======================================== This file is displayed before the directory listing (RIPscrip), which creates an interface for the caller to browse the files in. To create your own file interface you *MUST* use these specification: 1. A text window size 80x24 2. 24 mouse regions 80x1 (one for each text line). A. Mouse regions coordinates should be (1,y),(80,y+1). For example: line 1 would begin at (1,1) and end at (80,2) of the TEXT WINDOW and line 15 would have coordinates (1,15) and (80,16). B. When clicked on, the region *MUST* send the character specified on line 11 of FLAGPLUS.CFG, the line number, then enter. For Example (I used the "" character to begin sending RIP coords): line 1 would send "^A1^M" and line 15 would send "^A15^M". C. The character to begin sending mouse coordinates should be a uncommon character, such as "" (ASCII 1), so a caller won't by mistake press it and wonder why it won't respond to anything else (until enter is pressed). If you decide to use a character such as "", in the configuration file you *MUST* enter "" and the mouse region should have the control character "^A" otherwise the RIP terminal will NOT send the same character expected. Note: ONE character! Suggestion: Use a GRID, it makes it much easier and faster. I recommend using RIPaint to draw these files. Product Support and Upgrades ======================================== Both support and upgrade may be obtained from Reality's Edge BBS at (517) 349-0538 or (517) 349-0948. If you have a 9600+ baud modem, you may FREQ: REC:AUTO_LOGOFF : Automatic Logoff utility - FREEWARE + SOURCE REC:FLAG_PLUS : FLAG+ Directory Listing utility REC:PRODUCTS : Complete up-to-date product & FREQ listing Registration and Upgrades ======================================== Since I spent about 2 months on this program, so I'm only asking $15.00 U.S. dollars to encourage future BBS enhancements and to support my system. All upgrade for FLAG+ will be 100% free; if I end up changing the registration sequence(s), you can obtain a new registration code directly from my board on your first call. SEE REGISTRATION FORM: REGISTER.FRM Reality's Edge BBS - (517) 349-0538/0948 P.O. BOX 1353 Okemos, MI 48805-1358 USA - Paul Miller