ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

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

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / RA / LISTEM13.ZIP / LISTEM.DOC < prev next >

Wrap

Text File | 1991-05-30 | 24.6 KB | 1,004 lines

▄▓▓▓▓ █ ▄ ▄▄▄ ▄▄▄ ▄ ▄▄▄ ▄▄ ▄▄ tm █▓▓▓▓ █ █ ▀▄▄ █ ▀ █▄ █ █ █ █▓▓▓▓ █▄▄▄ █ ▄▄▄▀ █ █▄▄ █ █ v1.3 ▀▀▀▀ ▄▒▒▒▒ █▀▀▄ ▄▄ ▄▄▄ ▄▄▄ ▄ ▄ ▄▄▄ █ █ ▄▄ ▄▄▄ ▄▄▄ tm █▒▒▒▒ █▄▄▀ █ █ █ █ █▄ █▀▄█ █ ▀▄ ▄ ▄▀ █ █ █ █ █▄ █▒▒▒▒ █ █ ▀▄▄▀ █▄▄▀ █▄▄ █ █ █ ▀▄▀▄▀ █▀▀█ █▀▀▄ █▄▄ ▀▀▀▀ ▄░░░░ DOCUMENTATION ▀▀▀▀ Master File List creator for RemoteAccess v1.01 Written by Michael Reece Copright (c) 1990, 1991 by RodentWare. All rights reserved. Documentation Copyright (c) 1990, 1991 by Peter Kling, of The Computer Group Ltd. LISTEM.DOC version 1.3 [Page 1] L I S T ' E M =============== TABLE OF CONTENTS ------------------------------------------ Cover Page...............................1 Contents.................................2 Why List'Em..............................4 About ShareWare..........................5 Monies...................................5 Keys.....................................6 LISTEM-C.EXE..........................6-13 Filenames Sub-Menu Section...............7 Output File............................7 Header File............................7 Footer File............................7 LogFile................................7 Conditional Sub-Menu Section...........8-9 Show FileDates.........................8 Show FileSize..........................8 Show Missing...........................8 Form Feed..............................8 Show Comments..........................8 Append Stats...........................9 Wrap Descriptions *...................9 New Files Only.........................9 Log Process............................9 Others Sub-Menu Section...............9-10 Description............................9 New Character *......................10 Days for New..........................10 Toggle Areas for Listing..............10 Info Line.............................10 Extensions *.........................10 Edit Sub-Menu Section................11-12 Add Orphans...........................11 Kill Missing..........................11 Sort FILES.BBS........................11 Kill Backup...........................12 Add Description.......................12 Fix Filenames.........................12 Toggle Help Windows Sub-Menu............12 Exit Sub-Menu Section...................13 Return to Dos.........................13 Make List *..........................13 Load New Config *....................13 Additional Information..................13 Shell to DOS............................13 LISTEM.EXE...........................13-14 LOG FILE................................14 LISTEM.DOC..............................15 LISTEM.TOP..............................15 LISTEM.END..............................15 LISTEM.DOC version 1.3 [Page 2] ALLFILES.LST............................15 RODENT.LST..............................15 PRODUCT.REG.............................16 Product Support Echo....................16 Product Support Boards..................16 Special Notice..........................17 LISTEM.DOC version 1.3 [Page 3] WHY LIST'EM ----------- List'Em was written because of the same problems that everyone has with their favorite files list creator. Either it isn't fully configurable, or the configured output does not offer any fancy graphic headers, title bars, or footers. Some of the important features of List'Em are: ---------------------------------------------- * Directly supports RemoteAccess's FILES.RA file * Allows optional Header and Footer text files per config. * List'Em will create FILES.BBS (or FILES.###) if it's not found. * Supports multiple configuration files with full file area configuration. List only the areas you want in each list. * Advanced FILES.BBS handling: optional sorting, descriptions, and case of filenames. Additional options include deleting FILES.BAK & missing files from FILES.BBS when done processing. * Speed of List'Em: List'Em will process 150 files files in 20 seconds. * Optional FILSEARCH.CTL conversion to FILES.RA included. * File Statistics Chart option available, for the complete processing of your files. * Added features for registered users. * Additional direct support of product thru the 'RODENT' echo. The 'RODENT' echo is available in Zone 1 through the Fidonet Backbone. * Automatic ERRORS.LOG created if any problems should occur. * Word-wrapping option available for better listing output of longer descriptions on files. The maximum size of a listing in FILES.BBS is 180 Characters. NOTE: All listing and description that are maked with an "*" have been improved or added to this version of List'Em. LISTEM.DOC version 1.3 [Page 4] ABOUT SHAREWARE --------------- Well everyone says they will not try out a program that does not let them test it first without delays. ShareWare means that you have the right to test the product for a period of no more that 30 days. At the end of thirty (30) days you must either stop using the product or register your copy. It's that simple, and hopefully people will register! Registrations lead to more programmers turning to the ShareWare concept. ┌────────────────────────────────────────────────────────────────────────┐ │ Registration Notice │ │ Unregistered Evaluation Version │ │ │ │ While this product is distributed freely, it is not free. It has been │ │ released under a software concept known as Shareware, which entitles │ │ you to evaluate this product free of charge for a maximum of 30 days. │ │ Afterwards, if you continue to use this software, you are required to │ │ register. │ │ │ │ Registration costs only 10$ in US funds, and entitles you to full │ │ support, notice of new releases, and removal of this screen. You will │ │ never have to re-register a later version of this program. │ │ │ │ For full registration details and special registration offers, please │ │ see the documentation accompanying this software, or File REQuest │ │ RODENT.REG from 1:3801/42 (fidonet). │ │ │ │ Thank you for supporting this program - Michael Reece (author) │ │ │ └─────────────────────────────────────────────[Press any key to continue]┘ MONIES ------ There are currently two ways to register a program from Michael Reece of RodentWare. One is a registration for the program that you are currently using, List'Em. The second is to register as a RodentWare 'supporter,' and obtain a registration (and RODENT.KEY) for all current, and future, RodentWare programs. LISTEM.DOC version 1.3 [Page 5] KEYS ---- $ 10.00 will get you a LISTEM.KEY for your product registration KEY. $ 50.00 will get you a RODENT.KEY for your RodentWare registration KEY. LISTEM-C.EXE ------------ List'Em-C is the configuration program, and this is the most important part of the List'Em process. Basicly, you can figure out how to make List'Em work with out the documentation, but there are a few added tips included. So lets just get started with the config program. The first step is to type LISTEM-C at the DOS prompt like below. LISTEM-C.EXE will load and read your FILES.RA file to configure your choices of file areas. If this is the first time you have run LISTEM-C or you have moved or changed the name of LISTEM.CFG you will be notified that List'Em is creating new configuration file. To use a configuration file other than LISTEM.CFG, enter the path and name on the command line. C:\RA>LISTEM-C - or - C:\RA>LISTEM-C SUPPORT.CFG LISTEM.CFG · add configuration description here ┌──────────────────────────────────────────────────────────────────────────┐ │ Filenames Conditionals Other Edits Help eXit │ └──────────────────────────────────────────────────────────────────────────┘ After the FILES.RA have been read and configured you are ready to proceed forward. Next you are presented a window with your choices to setup your configuration file. (Note all screen captures that are show with-in this documentation package have been stripped of the background colored windows. Also note that the window shown maybe appear out of alignment from that shown here.) LISTEM.DOC version 1.3 [Page 6] FILENAME SUB-MENU SECTION ~~~~~~~~~~~~~~~~~~~~~~~~~ OUTPUT FILE ----------- This is the <filename> that you have chosen for your master file list, or Output File, that will be created by List'Em. HEADER FILE ----------- This file is added into the master file list very similar to an introduction of a paper. This file may contain information about your BBS. You must create this file with your favorite Editor. If desired, this file can be of ANSI nature. FOOTER FILE ----------- This file added to the end of the master file list as a closing statement would finish the paper. This file may list other miscellaneous information, such as file aliases supported for file requests. This file is also created by you can be of ANSI nature. LOGFILE ------- Here you select the log file to be used. If you are like I am, you may want to have everything pointing to a single log file. This will default to LISTEM.LOG if you don't change it. LISTEM.DOC version 1.3 [Page 7] CONDITIONALS SUB-MENU SECTION ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SHOW FILEDATES -------------- This option will allow you to toggle the display of the file dates in the Output File that you have chosen. SHOW FILESIZE ------------- This question will determine the display of the size of each file from your FILES.BBS in the Output File. SHOW MISSING ------------ With this option, you decide if you will post the name of the 'missing' or 'offline' programs in your Output File. FORM FEEDS ---------- Invoking this option will place a form feed at the beginning of each file section. This can be handy for separating file section on print outs, or for page control of output when displaying online with your BBS. SHOW COMMENTS ------------- This option is to decide if you would like to list the FILES.BBS comments and headers in your Output File. LISTEM.DOC version 1.3 [Page 8] APPEND STATS ------------ This options will append a detailed file statistics report at the end of the file listing. WRAP DESCRIPTION ---------------- With this selection turned on, long file descriptions will wrap to the next line. Otherwise, they will extend beyond the 80th column. NEW ONLY OPTION --------------- Invoking this option will cause the chosen Output File to display only new files by date set by # of days for new option in List'Em. LOG PROGRESS ------------ This option allows you to toggle the creation of log reports. OTHERS SUB-MENU SECTION ~~~~~~~~~~~~~~~~~~~~~~~ DESCRIPTION ----------- This description will be added to files that do not already have a description; such as 'Description not Found'. LISTEM.DOC version 1.3 [Page 9] NEW CHARACTER * ------------- This option specifies what letter or symbol will be used to indicate the newer files in your Output File. Use your arrow keys or mouse to select the character you wish to use and press <Enter>. DAYS FOR NEW ------------ Now you are prompted for the number of days a fill will be considered new on your system. These files will be marked with the 'New Character' above. TOGGLE AREAS FOR LISTING ------------------------ This option will present you with a list of your file areas. You can toggle areas to be listed in the Output File. Use your arrow keys to scroll the list, and press <Space> to toggle them. INFO LINE --------- The string in this position will be displayed on the screen during List'Em runtime. It will also be placed at the top of the Output File. This is basically a simple description or tag line for your listing. You might call your Output File '267_269.LST,' but that doesn't isn't very clear; so in this option you call it "Master File List for FidoNet 267/269." Then that description will be displayed at run time and in the output list. EXTENSIONS * ---------- As a registered user of List'Em, you can change what extensions are counted in the file statistics chart. Now you can keep track of different file extensions, such as those in SDN distribution files. LISTEM.DOC version 1.3 [Page 10] EDIT SUB-MENU OPTIONS ~~~~~~~~~~~~~~~~~~~~~ These sub-menu options will help you create and maintain your FILES.BBS for each directory. ADD ORPHANS ----------- Invoking this option will add all existing files not found currently within the FILES.BBS list for each directory. Note that all files beginning with FILES (FILES.*) will not be added to the listing. This is to prevent FILES.BBS and FILES.BAK from being placed in your Output File. KILL MISSING ------------ This option will remove the names of files that are not found in the directory, but are listed in the FILES.BBS. SORT FILES.BBS -------------- This option will sort the FILES.BBS list in alphabetical order under each given comment/heading. Notice that in the following example, the first two files are sorted under the first comment. A blank line separates the next three, which are in turn sorted. After the final comment, the remaining files are sorted as well. Take a look: (imported partial FILES.BBS from 1:3801/42) - Master File Listings, BBS Listings, etc. - 3801_42.LST File Listing - All Files on This BBS (Text) 3801_42.NEW File Listing - All NEW Files on This BBS (Text) RODENT.LST Listing of all RodentWare programs (Text) TYLR0990.LST Tyler BBS List (Distribution) Sept, 1990 (Text) TYLR0990.ZIP Tyler BBS List (Distribution) Sept, 1990 (Zip) TYLR_APP.TXT SYSOPS: Questionnaire for BBS Listing - Recent Uploads (Unchecked) Download At Your Own Risk! - AG.ZIP Funny Letter To AG Dept. LISTEM.DOC version 1.3 [Page 11] BIGRIG.ZIP drive 18 wheeler cross country BUBBLE.ZIP lovely bubble dragon, for EGA. COLDIR15.ZIP nice pgmbl color dir. ESN.ZIP Everyone's Shareware Nightmare - GOOD! LABELS.ZIP 3 LINE DISK LABEL MAKER-p.d. LASTCALL.EXE Make Ansi file like menu type 59? SCANV67C.ZIP 10-15-90 DETECTS JERU-B VIRUS SPELLER.ZIP Help your child learn spelling words KILL BACKUP ----------- This option will assist you in deleting the FILES.BAK that is created when you edit or sort the FILES.BBS. ADD DESCRIPTION --------------- Here you specify if the 'Other|Description' line should be permanently written into the FILES.BBS as well as the Output File. FIX FILENAMES ------------- You have the choice of one of the following ways of modifying the <filenames> in FILES.BBS: UPCASE: Will place the <filenames> in all capital letters. DOWNCASE: Will place the <filenames> in all regular letters. PROPER: Will start each <filename> word with a capital and the rest will be regular letters. NO CHANGE: Will leave <filenames> just as they are found. TOGGLE HELP WINDOWS SUB OPTION ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This option will toggle the additional comments provided by the program at the bottom of your screen. LISTEM.DOC version 1.3 [Page 12] EXIT SUB MENU OPTION ~~~~~~~~~~~~~~~~~~~~ RETURN TO DOS ------------- This will check to see if you want to save the work or run you have just configured, and then return to DOS. Your options are to 'Yes,' to save the changes, 'No' to abort your changes, and 'Cancel' to remain in List'Em-C. MAKE LIST * --------- A handy addition to this package; once you have configured your file list, now you can actually run LISTEM without leaving the LISTEM-C enviroment. LOAD NEW CONFIG * --------------- Additionally, you can now work on one file list and then switch to a new file list configuration without exitting the program. This means for less dos commands to waste your time with. ADDITIONAL INFORMATION ~~~~~~~~~~~~~~~~~~~~~~ Once you have completed selecting your files list, you have completed the hardest part of the List'Em process. SHELL TO DOS ------------ LISTEM-C now features a 'Shell to DOS' option. Press <Ctrl>, <Alt> & <Shift> at the same time to invoke this option. Type 'Exit' to return to List'Em-C. LISTEM.DOC version 1.3 [Page 13] LISTEM.EXE ---------- This is the main EXE program to run to create your master files listing. Like LISTEM-C, there are two ways to invoke this program. The first is simple; type 'LISTEM' which will take the default configuration file (LISTEM.CFG) and create the proper files list. The second option is probably the most important if you plan to make special listings of specific areas, such as the included example file, RODENT.LST. To use this feature, you must invoke LISTEM.EXE with an optional command line variable specifying the proper configuration file to use, such as "LISTEM RODENT.CFG". LOG FILE -------- List'Em now displays all the information about it's processing. Example of what the log entry will look like is shown below. The location of the output is controlled by your configuration, or sent to 'LISTEM.LOG'. ---------- Wed 05 Dec 90, List'Em v1.1 (LISTEM.CFG) > 21:24:06 List'Em v1.1 configuration file . 21:24:06 C:\RA\TXTFILES\SUPPORT.LST . 21:24:06 Support Files List for FidoNet 1:267/169.0 ? 21:24:06 File area name -> (total,offln, new, kb) @ 21:24:20 COMPUTER GROUP SUPPORTED FILES -> ( 45, 0, 19, 2529) % 21:24:22 Totals: 1 areas, 45 files, 19 new, 2529 (k) LISTEM.DOC version 1.3 [Page 14] LISTEM.DOC ---------- This documentation package is provided and Copyrighted (c) 1990 by: Peter Kling of The Computer Group Ltd, P.O. Box 8453, Albany, New York, 12208. Available through FidoNet's 1:267/169.0 and/or 1:267/269.0. For printed copies of these documentation please contact Peter Kling. A small charge of $5.00 plus shipping is required. LISTEM.TOP ---------- A sample top file for your master file list is included. This can be created with your favorite editor. One note: if you intend on printing you master file list, you will not want to include ANSI graphics in this and all textfiles. LISTEM.END ---------- A sample closing file for your file list is also included; This file is also created by you with your favorite editor. ALLFILES.LST ------------ A completed file list, created by List'Em, is included to show you how your master list could look. RODENT.LST ---------- A sample RodentWare files list, created by List'Em, is included as well. This file will give you and idea of the realm of programs available from RodentWare, and also show how you can use LISTEM to only list selective areas. LISTEM.DOC version 1.3 [Page 15] PRODUCT.REG ----------- A registration form to obtain you key is provided. Registering will help support the ShareWare programming system, and, more importantly, RodentWare. PRODUCT SUPPORT ECHO -------------------- A special announcment goes out to all of you to invite you to join with the beta testers in a new support echo titled 'RODENT'. The RODENT echo is to aid support to all RodentWare users without adding more wear and tear on the other echoes. Ask your *EC about receiving this echo. RODENTWARE SUPPORT SYSTEMS -------------------------- Below is a listing of RodentWare Support systems. These bullet- in boards should have all of the latest RodentWare programs available for File REQuest and/or Download. Improbability Drive II Computer Castle BBS SysOp, Michael Reece SysOp, Michael Lewis Tyler TX USA Gray LA USA 903 566-5162 (Data) 504 876-3138 (Data) 1:3801/42 (@fidonet) End of the World The Dog House SysOp, Lou Ludwig SysOp, Dave Lockard Fortuna CA USA Charlotte Hall MD USA 707 725-5786 (Data) 301 884-3686 (Data) 1:125/12 (@fidonet) 1:109/605 (@fidonet) The Low Country Computer Group Ltd (1) SysOp, Tom Echols SysOp, Peter Kling Burton SC USA Albany NY USA 803 524-5056 (Data) 518 437-1267 (Data) 1:372/15 (@fidonet) 1:267/169 (@fidonet) dataMatrix! Odyssey BBS SysOp, Stuart Henderson SysOp, Stan Hirschman Exeter Devon UK Edina MN USA +44 392 434477 (Data) 612 832-5127 (Data) 2:255/13 (@fidonet) 1:282/40 (@fidonet) The Fox's Den The Other Side of the Hill SysOp, Jym Fox SysOp, Robby Barra Valdosta GA USA Tyler TX USA 912 245-7655 (Data) 903 597-1239 (Data) 1:370/530 (@fidonet) 1:3801/3 (@fidonet) LISTEM.DOC version 1.3 [Page 16] The Computer Group Ltd is the Distribution Coordinating Site for all of our RodentWare Products, as well as the home base for our RODENT Support Echo. SPECIAL NOTICE -------------- A real special thank you goes out to all of the RodentWare support beta testers. There never was a better bunch of hard working people. Anytime a suggestion was needed they were there to just lend a helping hand. LISTEM.DOC version 1.3 [Page 17]