home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / CEREBRUM / WWCFL101.ZIP / WWCFL.DOC < prev    next >
Text File  |  1994-02-12  |  5KB  |  126 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │                                                                            │
  3. │                              WWIV CFL v1.00                                │
  4. │                   Copyright (c) 1993-1994 by Frank Reid                    │
  5. │                            All Rights Reserved                             │
  6. │                                                                            │
  7. │                   An External File List Creation Utility                   │
  8. │                        for WWIV v4.23 BBS Systems                          │
  9. │                                                                            │
  10. └────────────────────────────────────────────────────────────────────────────┘
  11.  
  12. I. Introduction.
  13.  
  14. WWIV CFL is a utility which creates a file listing suitable for download and
  15. printing.  The major improvement over other such utilities is WWCFL's ability
  16. to include only a specific conference and/or directories of a specific DSL.
  17. This is extremely useful for generating different listings for different parts
  18. of your BBS.
  19.  
  20. II. Installation.
  21.  
  22. To install WWIV CFL, simply copy WWCFL.EXE to your main WWIV directory.  WWCFL
  23. needs no external files, as it reads your CONFIG.DAT and directory information
  24. files from DATA\ directory.  No files are modified.  WWCFL creates its listing
  25. in a file named FILES.BBS which will be sent to your GFILES directory.
  26.  
  27. WWCFL uses ANSI.SYS rather than graphic screen calls for cursor positioning and
  28. colors.  I hope I'm accurate in assuming most Sysops will have ANSI.SYS loaded,
  29. but if not the list will look really bad!  Drop me a note and I can compile it
  30. with no effects if you need.
  31.  
  32. III. Usage.
  33.  
  34. The simplest way to use WWCFL is just type "WWCFL" at the DOS prompt.  This
  35. creates a listing of all files in all directories within all conferences, ie.
  36. a master file listing.  Most folks will use WWCFL within a batch file and as
  37. part of a daily external event, though.  If you already have a downloadable
  38. master file listing in one of your WWIV BBS directories, your external event
  39. batch file can freshen the listing as part of your daily event.
  40.  
  41. If "New Uploads" was in the directory path "D:\UPLOADS\" the following commands
  42. will refresh the list each day:
  43.  
  44.    WWCFL
  45.    PKZIP -M D:\UPLOADS\FILELIST.ZIP GFILES\FILES.BBS
  46.  
  47. In addition, WWCFL will take several command line parameters to adjust your
  48. listing:
  49.  
  50.    WWCFL <DSL> <CONFERENCE DESIGNATOR> <-T> <-?>
  51.  
  52. <DSL> is the highest directory security level, as specified in //DIREDIT, to
  53. include in the list, e.g. "WWCFL 100" would generate a listing of all files in
  54. all directories which would be visible to a user with DSL 100.
  55.  
  56. <CONFERENCE DESIGNATOR> is the conference designator, as listed in //CONFEDIT,
  57. to generate a listing of directories within that conference, e.g. "WWCFL A"
  58. would include all directories in conference "A".
  59.  
  60. <-T> tells WWCFL to include the "Top Ten Downloads" as a separate portion of
  61. the listing.  When specified, the most popular downloads will be displayed at
  62. the top of the listing before the rest of the directories.
  63.  
  64. <-?> produces a brief help screen on usage.
  65.  
  66. All parameters (except "Help") can be used in conjunction with one another.
  67. For example, "WWCFL 100 S -T" would create a listing of all files in Conference
  68. "S" visible to DSL 100, and will also create the Top Ten Downloads listing at
  69. the top of the file.
  70.  
  71. IV. Registration.
  72.  
  73. Registration is only $5.00!
  74.  
  75. In addition to the good feeling you'll get by registering this program and the
  76. encouragement you'll give me to work on future modifications and utilities,
  77. the registered version also removes the 15 second delay upon completing a file
  78. listing and enables you to name the output file to something other than
  79. FILES.BBS in your GFILES\ directory.
  80.  
  81. Users who send $20 (or more!) will receive my undying gratitude and the full
  82. source code to WWCFL on diskette.
  83.  
  84. Send registrations to:
  85.  
  86.     Frank Reid
  87.     9350 Harvest Way
  88.     Laurel, MD 20723
  89.  
  90. V. Disclaimer.
  91.  
  92. The author makes no warranties, expressed or implied, as to the quality or
  93. performance of this program.  Your use of this program constitutes your
  94. release of the author from liability or litigation for any indirect or
  95. consequential damages arising from the use of this program or its associated
  96. files.
  97.  
  98. In no event will the author be liable to you for any damages, including any
  99. lost profits, lost savings or other incidental or consequential damages
  100. arising out of your use or inability to use the program, or for any claim by
  101. any other party.
  102.  
  103. VI. History.
  104.  
  105. Version 1.00 (02/11/94)
  106.   - Initial release
  107.  
  108. Version 1.01 (TBD)
  109.   - Made -T (Top Ten Download List) the default, -T now toggles this off.
  110.   - Added -D option to use actual file date (vice upload date) for non CDROM.
  111.   - Cosmetic changes to the header box for each directory.
  112.  
  113. Thanks to all the Sysops who've made releasing modifications and utilities fun!
  114. Comments, criticisms, and suggestions for improvement should be directed to:
  115.  
  116.     WWIVnet  : 1@3113
  117.     IceNET   : 1@3100
  118.     FILEnet  : 1@1160
  119.     Fidonet  : 1:109/568
  120.  
  121. You can always find the latest version on:
  122.  
  123.                               Eagle's Dare
  124.                              (301) 498-1984
  125.                              14.4K/24 Hours
  126.