The World of Computer Software

home *** CD-ROM | disk | FTP | other *** search

/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / s / syread03.zip / DOCUMENT.LST < prev next >

Wrap

File List | 1992-03-03 | 19KB | 390 lines

╔═══════════════════════════════════════════════════════════╗ ║ S Y N E R G Y A L L F I L E S R E A D E R v0.2ß ║ ║ a utility for Searchlight BBS sysops and users ║ ║ Copyright(c) 1992 ║ ║ Synergy Computer Systems ║ ║ Cocoa Beach, Florida ║ ╚═══════════════════════════════════════════════════════════╝ SLDIR Directory Listing for 2-24-92 [SLDIR ? for Help] /│\ /│\ └── Geez, it would sure be nice to be and what about ──┘ able to automatically change "SLDIR" this little fiasco? to the name of your BBS, no? Believe it or not, I had a new user, who B.T.W. was also new to Well, there is just one more thing computing, downloaded I dislike about SLDIR.EXE . . . my allfiles list and a WHAT IS A SEARCHING????? copy of LIST.COM. The It comes from the heart of the file next day he asked me WHY system of Searchlight and is used the help doesn't work! generically for the "Zippy" and "New" ┌── file scans. \│/ Searching INTRO This is not meant to knock Frank in any way, in fact it's about my only real(?) complaint about Searchlight. Okay, on with the demo . . . ┌── Something you will need to know. \│/ NOTE: .LST is the required extension for allfiles lists to be processed/read by this package ie . . . SLDIR -INCLUDE 99 > SYNERGY.LST As you must have figured out by now, we are about to solve these problems, but with NO, I repeat NO annoying "Register Me" notices plugged in for a replacement. Searching REGISTER <grin> I couldn't resist, no, you don't HAVE TO register this package, it is not crippled in any way, nor does it have a built-in time bomb. At the time of this publication, my BBS was/is down due to financial problems, (am I getting to you yet?) so tech support will be by mail only for unregistered users (though I doubt you will need any). Same goes for bug reports (sorry, and thank you for reporting them). NOTE: To distribute SYNERGY.EXE with your allfiles list you MUST read and adhere to the usage agreement at the end of this document. Allowing users to download SYNERGY.EXE is an admission of acceptance of the above stated usage agreement. Failure to adhere to the conditions of distribution set forth in the above stated usage agreement shall be considered a violation of Federal Copyright Laws and punishable by the full extent of the law. What you get for registering: 1) Customizable Colors. 2) All required files will use your BBS name (8 letters max) for their prefix. 3) Your BBS name and phone number on the top function bar. 4) Your BBS name on various dialog boxes throughout the program. 6) Enhanced MAKEIDX.EXE - directory descriptions, command line switches, more! 5) Free upgrades as they become available. 6) The phone number of my favorite BBS. 7) My undying gratitude (and cat if you want it!). Searching GET REAL Okay enough of the sales pitch, and now, onward . . . If you have already tried using the "Jump" command, you found it didn't work, that is because the required file (SYNERGY.IDX, in the UNREGISTERED version) needs to be created by MAKEIDX.EXE, which also modifies the .LST file. So, the next logical step is to run MAKEIDX, as soon as you press <Esc> my batch file will take control, rename a couple of files included in this package, run MAKEIDX then return you to this program to see the changes. AT THAT TIME: Press <J> and select MAKEIDX. Press <Esc> now! Searching MAKEIDX Okay, so I lied, as you can see, you can change the colors (big deal). The MAKEIDX is designed to run from inside a batch file (no user input required) so that you can run it during any event than that runs SLDIR, whether that event is a BBS maintenance event, a door for custom "User Level" Lists or from DOS. While SYNERGY.EXE is intended to freely distribute to your users, MAKEIDX.EXE is NOT to be distributed with your BBS Allfiles list, it is for the sole use of the host BBS system. The unregistered MAKEIDX.EXE requires a configuration file (MAKEIDX.CFG - optional with Enhanced MAKEIDX) to set colors and know what strings to look for and append. the format of MAKEIDX.CFG is as follows: ;3 <-- Main Text Color. ;0 <-- Main Background Color. ;15 <-- Message Text Color. ;1 <-- Message Background Color. ;Your BBS Name <-- Replacement string for "SLDIR" (max 15 characters). ;Synergy <-- Legal DOS prefix for the .IDX and .LST files. ;Searching <-- Original directory prefix string (max 15 characters). ;Directory <-- Replacement string for dir prefix (max 15 characters). ;(407) 555-1212 <-- Your BBS Phone number. Searching COLORS Lines 1 through 4, legal values for colors: ┌────────────────┐ ┌───────────────────┐ │ Background │ │ Text Colors │ ├────────────────┤ ├───────────────────┤ │ Black = 0 │ │ Background Colors │ │ Blue = 1 │ │ DarkGray = 8 │ │ Green = 2 │ │ LightBlue = 9 │ │ Cyan = 3 │ │ LightGreen = 10 │ │ Red = 4 │ │ LightCyan = 11 │ │ Magenta = 5 │ │ LightRed = 12 │ │ Brown = 6 │ │ LightMagenta = 13 │ │ LightGray = 7 │ │ Yellow = 14 │ └────────────────┘ │ White = 15 │ └───────────────────┘ Searching STRINGS Lines 5 through 8 provide the required information to first scan the ????????.LST file, then create the ????????.IDX file and finally append the ????????.LST file for use with the ????????.IDX file in SYNERGY.EXE Reader. NOTE: though SYNERGY.EXE may be renamed to your liking, and MAKEIDX will append any .LST file with a legal DOS prefix (defined in MAKEIDX.CFG), SYNERGY.EXE (UNREGISTERED) will ONLY read/use the file names SYNERGY.LST and SYNERGY.IDX The MAKEIDX utility processes the .CFG file one character at a time, counting each space, if there is more than one space in a row it is interpreted as the end of the string, records that value, then goes to the next line. All strings are limited to 15 characters long (EXCEPT for line 6, which is limited to 8 characters) and may be any ASCII character in the decimal range of 32 to 254 (see the ASCII table in your DOS manual), though I recommend using the range of 32 to 126 (keyboard characters) due to lack of support for higher characters with some printers. Line 5 should contain the name of your BBS (less "BBS" - MAKEIDX adds " BBS" to the end of this string. This string replaces the string segment "SLDIR" on the first line after the SLDIR.TXT insert (see SLDIR.DOC, included in SLDIR.ZIP, for more information on SLDIR.TXT). This line is also passed to the .IDX file for use by the end-user registered version of SYNERGY.EXE (allows the home viewer to retain/switch between multiple .LST and .IDX files from different BBS' from within the reader. NOTE: if the SLDIR string does not exist, then this string will be ignored while processing the .LST file. Line 6 is the prefix name of the .LST file to be processed and the .IDX file to be created. Line 7 is the string that MAKEIDX will look for in the .LST file (prior to appending) that signifies "This line is a directory name!". It should include all characters up to, but not including any directory name. Though I have not tested this with allfiles lists created by utilities other than SLDIR, I added this feature in hopes that this package would work with most any BBS. Line 8 is the string that you wish to replace line 7 with in the appended .LST file. if you wish for the appended version of .LST to retain the old directory prefix (line 7) then this line should duplicate line 7. Line 9 is the phone number of your BBS. This line is tagged on to the end of the appended SLDIR line and replaces "[SLDIR ? for Help]". This line is also added to the .IDX file for use by the end-user registered version of SYNERGY.EXE (where it will be placed on the top line along with the name of your BBS). NOTE: In the Registered BBS version your BBS name and phone number is hard coded into the program. Searching SYNERGY The reader itself, is rather cut and dry, self explanatory, easy to use, user friendly, (Keep it simple, stupid) etc . . . Searching KEYS The cursor keys ( Up/Down arrows, PageUp/PageDown, and the Home/End Keys) are the primary scroll control keys: Up Arrow takes you up (back) one line. Down Arrow takes you down (forward) one line. <PageUp> takes you up (back) one page. <PageDown> takes you down (forward) one page. <Home> takes you to the beginning of the file. <End> takes you to the end of the file. In addition to these primary scroll control keys you have a few more: <Alt-P> Estimates how many sheets of paper will be required to print the the .LST file, then gives you the option to quit or print the .LST file from line 1 to the end, giving you control over LPT1 or LPT2. Should printer failure occur, you are given the option to abort the printing attempt or fix the problem and continue printing. <J> By pressing <J> a pop-up dialog box with a scrollable selection bar will appear. Pressing <Esc> will abort the jump process, pressing enter will move you directly to the highlighted dir. <S> The search function will search only forward from your position in the file. When you press <S> a dialog box will pop-up, the cursor will turn on, and you will be asked to enter your search argument you will then have the option of whether you want to do a case sensitive search or if you want to ignore case. Searching FUTURE Future development of this package will depend greatly on your support and feedback. The next release will contain greatly enhanced search routines. mouse support, .PCX (or like image file) login/off BBS adds, and TSR off-line file tagging are planned for the near future. Searching BUG/IDEA Should you run across a bug or have an idea for something you would like to see added to this program please write me at: Ron Ryan Synergy Computer Systems 524 S. Atlantic Ave. #3 Cocoa Beach, Florida, 32931 Searching PACKING ╔══════════════╗ ║ Packing List ║ ╚══════════════╝ README 1ST ................ Instructions for DEMO.BAT. DEMO BAT ................ Demonstration Batch for MAKEIDX & SYNERGY. GO BAT ................ Simply "Type readme.1st" LN EXE ................ Sends a line-feed inside batch files. MAKEIDX EXE ................ Utility to make .IDX files and append .LST files. SYNERGY EXE ................ Main program - Synergy Allfiles Reader. ORDER FRM ................ BBS Registration/Order form. DOCUMENT LST ................ This document. SYNERGY SAM ................ Sample Allfiles list used by Demo. MAKEIDX SAM ................ Sample .CFG file used with SYNERGY.SAM by demo. FILEVENT ZIP ................ Batch file packet for filelist by event. FILDOR10 ZIP ................ A batch allfiles door - works much like an "Off-Line" echo reader - it allows you to select a download protocol, makes a custom allfiles list per users "file access level", zips up the packet, then initiates the download. Searching USAGE ╔═════════════════╗ ║ Usage Agreement ║ ╚═════════════════╝ To distribute SYNERGY.EXE with your allfiles list you MUST read and adhere to this usage agreement. Allowing users to download SYNERGY.EXE is an admission of acceptance of this usage agreement. Failure to adhere to the conditions of distribution set forth herein shall be considered a violation of Federal Copyright Laws and punishable by the full extent of the law. CONDITIONS OF DISTRIBUTION. 1) MAKEIDX.EXE may not be distributed with your allfiles list. It will, in fact, corrupt the .IDX file if it is run with a .LST file more than once. 2) You may freely distribute the shareware version of SYNERGY.EXE with your allfiles list if your BBS is a non-commercial BBS and you include all the files as stated in paragraph 4 with the download package. If any of the following apply to your BBS it is to be considered a commercial BBS and you must contact Synergy Computer Systems for a special licensing agreement: a. BBS is not open to the general public. b. BBS is operated from place of business. c. BBS charges a mandatory subscription fee for continued access. d. BBS charges money for download time. e. BBS' primary function is a marketing tool. f. BBS' primary function is a promotional tool. g. BBS operates as a tech-support board for any commercial products other than shareware software. 3) The following files must be included in an unmodified form with any download packet that contains SYNERGY.EXE and your allfiles list: a. SYNERGY.IDX as created by the MAKEIDX.EXE utility. b. SYNERGY.LST as appended by the MAKEIDX.EXE utility. c. SYNERGY.DOC - The end user documentation/registration form. (Packed in "FILDOR10.ZIP") 4) The following files from this archive must be excluded from any download packet that contains SYNERGY.EXE and your allfiles list: a. README.1ST b. DEMO.BAT c. GO.BAT d. MAKEIDX.EXE e. ORDER.FRM f. DOCUMENT.LST g. SYNERGY.SAM h. MAKEIDX.SAM i. FILEVENT.ZIP j. FILDOR10.ZIP 5) Paragraphs 4 and 5 do not exclude your right to include any additional files in your allfiles download packet. 6) Paragraphs 4 and 5 do not exclude your right to distribute .LST and/or .IDX files appended/created by MAKEIDX.EXE without SYNERGY.EXE. 7) The entire shareware Synergy Allfiles Reader archive, in an unmodified form, must be made available for download by visiting sysops. 8) SYNERGY.EXE and all accompanying files, as declared in the "Packing List" section of this document, are copyrighted material, and may not be modified in any way without the express written consent of Synergy Computer Systems. The sole exception to this paragraph is the renaming of SYNERGY.EXE to be included in your allfiles download packet to any name you so desire. The renaming of SYNERGY.EXE, in no way, exempts you from adhering to the conditions of distribution set herein. 9) Non-profit organizations such as computer user groups and educational institutions may be entitled to FREE registration. Contact Synergy Computer Systems on your official letterhead stating your dues if applicable and IRS status with a completed order form for more information. 10) Under no circumstances shall any party charge any money for any of the files listed in the "Packing List" section of this document beyond pre- set on-line charges or nominal distribution fees for mailing/diskettes. Any shareware distributor that distributes this package must clearly notify any said purchaser that they are not purchasing registration. 11) Non-BBS usage of this package will be considered a violation of Federal copyright laws. Should you have a desire to use this package for a non-BBS purpose contact Synergy Computer Systems for licensing and customized versions for your application. End of distribution agreement. Searching VERSIONS There are three versions of the Synergy Allfiles reader available: 1) This version (the shareware version) as described herein. 2) The Registered BBS Version. Cost $20 - Includes: a. Customized SYNERGY.EXE 1. Replacement of "Synergy" with your BBS name throughout the program. 2. Your BBS phone number on the top status bar. 3. Optional: Your color schem hardcoded into the program - will ignore the .IDX color directives. b. Unlimited distribution for non-comercial BBS' as described in paragraph 2 of the usage agreement. c. Exemptions from paragraphs 3 and 7 of the usage agreement. d. Enhanced MAKEIDX.EXE 1. Your BBS defaults hardcoded into the .EXE file. 2. The .CFG file is optional - only required to override hardcoded defaults. 3. Uses DISCRIPT.DIR - a standard ASCII file that contains directory discriptions up to 50 characters long. These discriptions are added to the directory name string in the .LST file during the append process. e. All distribution files use your BBS name, or your choice of abriviation for thier eight-letter DOS prefix (.EXE,.LST,&.IDX). f. Free upgrades. 3) The Registered End User Version. Cost $20 - Includes: a. Single site, single user license. b. Unlimited .IDX & .LST file handling - added command <B>, when called a pop-up dialog box, much the same as the "Jump" command, appears that allows you to choose the BBS list you wish to view. Once selected, the predefined BBS colors for the selected BBS take over, the name and phone number of the board are placed on the top status bar. c. Special utility, much like MAKEIDX.EXE except it requires user input of file names and strings to modify most any BBS' list for use with SYNERGYE.EXE d. Free upgrades.