home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / SPITFIRE / S_LIST11.ZIP / SPITLIST.DOC < prev    next >
Text File  |  1994-01-21  |  7KB  |  179 lines
  1.  
  2.      ███████╗ ██████╗  ██╗ ████████╗ ██╗      ██╗ ███████╗ ████████╗
  3.      ██╔════╝ ██╔══██╗ ██║ ╚══██╔══╝ ██║      ██║ ██╔════╝ ╚══██╔══╝
  4.      ███████╗ ██████╔╝ ██║    ██║    ██║      ██║ ███████╗    ██║
  5.      ╚════██║ ██╔═══╝  ██║    ██║    ██║      ██║ ╚════██║    ██║
  6.      ███████║ ██║      ██║    ██║    ███████╗ ██║ ███████║    ██║
  7.      ╚══════╝ ╚═╝      ╚═╝    ╚═╝    ╚══════╝ ╚═╝ ╚══════╝    ╚═╝
  8.  
  9.                            V1.1  by Gary Korisko
  10.                             The Pseudo Node BBS
  11.                               (402) 896-3489
  12.                           CircuitNet Node #402012
  13.                        Proudly Running Spitfire V3.4!
  14.              ╔═══════════════════════════════════════════════╗
  15.              ║    A fully configurable multiple-file area    ║
  16.              ║  lister for Spitfire Bulletin Board Systems   ║
  17.              ╚═══════════════════════════════════════════════╝
  18.  
  19.  
  20.  
  21.  
  22.  
  23. DESCRIPTION:
  24.  
  25. Spitlist is a utility that will list all files available for download on your
  26. Spitfire BBS. You may ask, "Aren't there already a bunch of utilities that do
  27. that?!!"...and the answer is, "Yes...but not in the same way." Most of these
  28. utilities make ONLY a complete list of each and every single file on your BBS.
  29.  
  30. How is SPITLIST different?  Well, as opposed to making one 400K plus file of
  31. everything on your board, this little puppy will make one list for say all
  32. your programming files....one list for your games...another for all of your
  33. BBS utilities...another for all of your CD ROM areas and so on.  Is it a
  34. little more work? Yep! You'll need to write a config file for each list you
  35. want and write a couple extra lines in your SF.BAT.  But it is more
  36. convenient for your callers who maybe want a game and don't want to fish
  37. through 6 or 7 thousand other titles to find it.  Also, it takes your
  38. average caller less time out of their busy little day and less time on your
  39. board to download a 20K text file. And lastly...when your average BBS
  40. hobbyist downloads a 400K text file and tries to look at it in DOS Edit with
  41. 2 Meg of RAM...guess what? Out of memory! Game over! So yes, this utility
  42. requires minimal typing on your part for a ONE TIME setup, but it's ever so
  43. convenient for everyone involved when all is said & done.
  44.  
  45.  
  46. SETUP:
  47.  
  48. Setup is easy. (If I had a nickel for every time I read THAT sentence......)
  49. But it really is in this case. Make a directory called SPITLIST on your "C"
  50. drive. Why C? Because!! Now....unzip the contents of this package in that
  51. 'ol C:\SPITLIST directory.  Done! Tah-Dah!
  52.  
  53. THE CONFIG FILE:
  54.  
  55. This part is easy, too...but more time consuming. The config file needs to be
  56. named LIST.CFG and should look like This:
  57.  
  58. The Pseudo Node BBS
  59. Omaha, Nebraska
  60. (402) 896-3489
  61. Gary Korisko
  62. C:\sf\game\sffiles.bbs
  63. C:\sf\bbs\sffiles.bbs
  64. C:\sf\dos\sffiles.bbs
  65. D:\sf\programs\sffiles.bbs
  66. F:\sf\ansi\sffiles.bbs
  67. C:\sf\display\sffiles.14
  68.  
  69. That's it.  Here's The breakdown:
  70.  
  71. LINE 1: BBS Name
  72. LINE 2: BBS Location
  73. LINE 3: Phone Number
  74. LINE 4: SysOp Name
  75. LINES 5 - INFINITY: The drive, path & Filename of your SFFILES.BBS/XXX
  76.                     that you want to list.
  77.  
  78.  
  79. So how does this thing make multiple lists? Batch Files, my friends! For
  80. instance, you want to make a list of your programming files AND a list of
  81. your BBS-type files. You use two config files that are re-names and rotated
  82. by the batch file. A sample batch file is included, and you need only edit,
  83. cut, and paste to make it work for you. So here's your programming LIST.CFG:
  84.  
  85. The Pseudo Node BBS
  86. Omaha, Nebraska
  87. (402) 896-3489
  88. Gary Korisko
  89. C:\sf\BASIC\SFFILES.BBS
  90. D:\sf\PASCAL\SFFILES.BBS
  91. C:\sf\CPLUS\SFFILES.BBS
  92.  
  93. Then you'd have another .CFG file called L2.CFG (list2) for your BBS file
  94. list..it'd look like this:
  95.  
  96. The Pseudo Node BBS
  97. Omaha, Nebraska
  98. (402) 896-3489
  99. Gary Korisko
  100. C:\sf\bbsutil\SFFILES.BBS
  101. F:\sf\doors\SFFILES.BBS
  102. D:\sf\rip\SFFILES.BBS
  103.  
  104.  
  105. So then your SF.BAT would need to rename your .CFG files for you and your
  106. SPITLST.TXT (the file this program generates). Here's what your SF.BAT
  107. would look like now:
  108.  
  109. cd\C:\spitlist
  110. spitlist                        'Executes SPITLIST with the 1st .CFG file
  111. ren LIST.CFG L3.CFG             'Renames the .CFG you already used to L3.CFG
  112. ren L2.CFG List.CFG             'Renames the .CFG you're about to use LIST.CFG
  113. ren L3.CFG L2.CFG               'Renames L3.CFG L2.CFG so it's ready for next time.
  114. ren SPITLST.TXT PROGRAM.TXT     'Renames The list whatever you want.
  115. pkzip -a PROGRAM PROGRAM.TXT    'Optional Zipping of the file
  116. del PROGRAM.TXT                 'Deletes the copy you don't need
  117. copy PROGRAM.ZIP C:\program     'Puts the list where you want it.
  118. del PROGRAM.ZIP                 'Deletes the copy you don't need
  119. spitlist                        'Executes SPITLIST with the 2nd .CFG file
  120.  
  121. So the more seperate file lists you want to produce, the longer this .BAT
  122. gets.  Could you just have one .CFG file and make a list of everything on
  123. the board? Sure...but I recommend not doing that for the reasons above.
  124. If you hate batch files, break your file areas down into five to ten lists
  125. so as not to create too much work.  If you want, contact me and I'll help
  126. you with the batch file and the .CFG file rotating.
  127.  
  128. The program is designed to run as an event and works best that way. In the
  129. unregistered version, your BBS name will appear, but in place of the phone
  130. number, location & SysOp name will be a big    U N R E G I S T E R E D. The
  131. program is not crippled in any way other than that.
  132.  
  133.  
  134.  
  135. REGISTRATION:
  136.  
  137. In the spirit of Mike Woltz's fair treatment of all of us Spitfire SysOps...
  138. registration for SPITLIST is only $2 if you download it from my BBS...$4 if
  139. you want me to mail the thing on a diskette. See the file REGISTER.FRM  
  140. included in this archive! By the way...as part of the registration fee...
  141. please drop a note or message next time you're on Buffalo Creek and let 
  142. Mike know how much you appreciate all of the low-cost high-quality work 
  143. he offers us day in and day out!  Happy BBSing!
  144.  
  145.  
  146.  
  147. LIMITATIONS:
  148.  
  149. As of yet, SPITLIST still won't fold laundry or wash the car.  Seriously, 
  150. though...SPITLIST is made to work with a maximum of 5 file description lines.
  151. That's four description lines and your "Uploaded By.." line.  Some people
  152. who run extra utilities that add extra lines should expect to lose that sixth
  153. line sometimes!  
  154.  
  155.  
  156.  
  157. FUTURE RELEASES?
  158.  
  159. I hear that the new version of SPITFIRE that is supposedly being beta tested 
  160. as we speak will support more than 4 lines of file descriptions.  At the time 
  161. that SPITFIRE 3.5 is released by Buffalo Creek, I will make a new version of 
  162. SPITLIST to accomodate...which will be free to all registered SPITLIST users!
  163.  
  164.  
  165.  
  166. THANKS TO THESE FOLKS! =====>
  167.  
  168. Mike Woltz, Creator of Spitfire BBS!
  169. Del Gonzales for de-bugging!
  170. Mike Noftzger of The Light House BBS in Omaha
  171.               for being painfully honest with 
  172.               version 1.0!  Should be faster
  173.               now, Mike!
  174.  
  175.  
  176.  
  177.  
  178.  
  179.