home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / uls213.zip / ULS.DOC next >
Text File  |  1994-02-11  |  6KB  |  152 lines
  1.  
  2. README.ULS (Documentation file for ULS213.ZIP)
  3.  
  4. ULS (UpLoader Scanner) version 2.13 (c)1994 Scott W. Wilson
  5.  
  6. ULS is a MAXIMUS BBS add-on, which adds the uploader's name (and the
  7. date uploaded) to the FILES.BBS in the appropriate directory.
  8.  
  9. The archive file, ULS###.ZIP includes both the DOS and OS/2 versions,
  10. and should have ALL of the following files:
  11.  
  12.       ULS.DOC       (Documentation for both versions)
  13.       ULS.EXE       DOS version
  14.       ULSP.EXE      OS/2 version
  15.  
  16.  
  17. Syntax (DOS version):   ULS.EXE   -S#  -C#  <path\filename>
  18.  
  19. Syntax (OS/2 version):  ULSP.EXE  -S#  -C#  <path\filename>
  20.  
  21. Where <path\filename> is the path and filename to the Maximus upload log.
  22.  
  23. -?    Displays a brief help screen
  24.  
  25. -S#   Sets number of leading spaces (# must be between 1 and 59,
  26.       default is 22 spaces)
  27.  
  28. -C#   Sets color (# must be between 0 and 16, default is no color
  29.       attribute added)
  30.  
  31.                        (1) (2) (3) (4)
  32.       Example: ULS -s# -c# -c# -c# -c# ul.log
  33.  
  34.       Colors are used as follows:
  35.  
  36.                   (1)        (2)   (3)   (4)
  37.               Uploaded by: The User on Feb-15-94
  38.  
  39.       If fewer than 4 colors are selected, the rest default to the
  40.       last color selected.
  41.  
  42.    |--Color Chart ("Mecca" colors)------------------------------------------|
  43.    |                                                                        |
  44.    |  0 - Black      4 - Red          8 - Dark gray     12 - Light red      |
  45.    |  1 - Blue       5 - Magenta      9 - Light blue    13 - Light magenta  |
  46.    |  2 - Green      6 - Brown       10 - Light green   14 - Yellow         |
  47.    |  3 - Cyan       7 - Gray        11 - Light cyan    15 - White          |
  48.    |                                                                        |
  49.    |------------------------------------------------------------------------|
  50.  
  51.  
  52.  
  53. PROGRAM USAGE AGREEMENT and DISCLAIMER:
  54.  
  55. "UpLoader Scanner" is FREE, however it is NOT "public domain" software.  
  56.  
  57. The author is the copyright holder and, as such, retains all rights to the
  58. program.  The author specifically grants the right to distribute the freeware 
  59. versions.  The original distribution archive must remain unmodified and
  60. intact.  You may not add files to the archive, and the three files listed 
  61. above must be present.  Neither the DOS version nor the OS/2 version of the 
  62. "UpLoader Scanner" program may be altered or included as part of another 
  63. software package, without first securing the author's written permission.
  64.  
  65. Although these programs are being distributed as "FREEWARE", the author
  66. requests that you REGISTER "UpLoader Scanner" by sending a NetMail message
  67. to the FidoNet address below, in order that you may be informed of updates.  
  68. You are encouraged to pass a copy of these programs along to your friends.  
  69. Please also encourage them to register.
  70.  
  71. Users of ULS and ULSP must accept this disclaimer of warranty: "UpLoader
  72. Scanner" is supplied as is.  The author disclaims all warranties, either
  73. expressed or implied, including, without limitation, the warranties of
  74. merchantability and of fitness for any purpose.  The author assumes no
  75. liability for damages, direct or consequential, which may result from the
  76. use of "UpLoader Scanner."
  77.  
  78.  
  79. Future improvements include:
  80.  
  81. + Ability to read Tic & JunkTick logs.
  82. + Addition of any good suggestions.
  83.  
  84.  
  85. Although written for Maximus, I'd be happy to try and adapt this program to
  86. other BBS software.  I will need a copy of an upload log, a FILES.BBS (or
  87. whatever it is called on your system), and the numeric codes for displayable
  88. colors (this program uses Maximus' defaults, not the standard ANSI colors).
  89.  
  90. Please send comments or suggestions for this program, and/or any voluntary 
  91. donations to my daughter's college fund, to:
  92.  
  93.              Scott W. Wilson
  94.              4 Saddle Rock Road
  95.              Danbury, CT 06811
  96.  
  97. Please NetMail your (FREE) registration to:             
  98.  
  99.              Scott Wilson @ FidoNet 1:141/950
  100.  
  101. You will be advised of major updates via NetMail.
  102.  
  103.  
  104.  
  105. Revision History:
  106.  
  107. 2.13 - Fixed a little bug that popped up with some 13 character filenames
  108.  
  109. 2.12 - N/A
  110.  
  111. 2.11 - !Cleaned up code for portability. Now released in DOS and OS/2.
  112.  
  113. 2.10 - +Added error handling for most occasions.  If there are any
  114.        errors or violations no updates will be made.
  115.        
  116.        +Added multiple color support.
  117.  
  118. 2.02 - +Added file verification.  Program will make no changes if any
  119.        involved files are not found.
  120.  
  121.        +Replaced FILO linked list algorithm with FIFO linked list.
  122.  
  123. Note:  This release was not ported to DOS due to portability problems.
  124.  
  125. 2.01 - !Fixed minor bugs and mites.  Tried tweeking for performance.
  126.  
  127. 2.00 - *OS/2 only. Not released for beta.
  128.  
  129.        +Added FILO linked list algorithm.
  130.  
  131.        !Fixed Color selection limits.
  132.  
  133.        +Added files.bbs backup.  Now renames old files.bbs to files.org.
  134.  
  135. 1.11 - +Added leading space stripping while reading log lines.  This will
  136.        not remove any existing leading spaces from the log, it will only 
  137.        prevent extra spaces before the uploader's name in files.bbs.
  138.  
  139.        !Changed positioning space limits from 0 - 19 to 1 - 59.
  140.  
  141. 1.10 - +Added date to uploader line.
  142.        +Added switch for setting leading spaces.
  143.        +Added switch for setting Mecca colors.
  144.  
  145. 1.00 - !Cleaned up code for DOS compiles.
  146.  
  147. Note:  First alpha release. Considered safe and stable.
  148.        OS/2 and DOS versions released together.
  149.  
  150. 0.90 - +ULS was born (No release - tested locally; OS/2 32 bit only)
  151.  
  152.