home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / bbs_oth / dlc_230.zip / DLC.DOC < prev    next >
Text File  |  1992-06-24  |  10KB  |  245 lines
  1. DLC.EXE v2.30 - A Maximus-CBCS v2.00 download counter
  2. Copyright (C) 1991, 1992 Robert Presland, all rights reserved.
  3.  
  4. Release Info * 24 Jun 92
  5. ------------------------
  6. This release is a beta release available to only those I give it to.
  7. Those wanting a copy need only ask me for one.
  8.  
  9. Release 2.21 and greater are major upgrades from previous releases, therefore
  10. you should read this file before using.  Previous releases were under the
  11. name DLCOUNT but since a utility already existed by that name, mine was
  12. changed to DLC.
  13.  
  14. This version uses a control file for it's parameters (you can only fit
  15. so much on a command line).  Please consult the distribution control
  16. file DLC.CTL for more details.
  17.  
  18. Bug Reports
  19. -----------
  20. Send bug reports to Robert Presland at 1:243/27.1, include the following:
  21.  
  22.    DLC.CTL
  23.    DLC.LOG
  24.    DLC.TMP (if found in he current directory)
  25.    FILEAREA.CTL (or equivalent)
  26.    MAX.LOG (or equivalent)
  27.    FD.LOG (if applicable)
  28.    BINK.LOG (if applicable)
  29.    FILES.BBS (if applicable)
  30.  
  31. Zip 'em up and send 'em off.  Many thanks to all that send me reports on
  32. my programs, it's a great help.  I welcome all comments and suggestions
  33. to the above node address.
  34.  
  35. So Why Use This Utility?
  36. ------------------------
  37. DLC currently supports FILELIST for CD-ROM users, mailer logs, extension
  38. exclusions, configurable counter delimiters, optional download log file,
  39. optional log file, multiple configuration files, configurable length
  40. counters, optional 'space for zero' counter, selective initialization,
  41. and will not process the same downloaded file more than once, as well as
  42. much much more.  Read the history section for a complete detailing of
  43. what has been added since the first release.
  44.  
  45. Archive
  46. -------
  47. You should have received DLC in an ARJ archive, with only the following
  48. three (3) files contained within:
  49.  
  50.      DLC.DOC   This text file
  51.      DLC.EXE   The exectuable
  52.      DLC.CTL   The control file
  53.  
  54. If one of these files is missing, or there are extra files, or the archive
  55. fails a CRC check, please file-request it from 1:243/27.
  56.  
  57. Description
  58. -----------
  59. DLC will process your Max log file and add a counter to the beginning
  60. of the description for each file downloaded.  A four digit counter is used
  61. (by default) to enable up to 9999 downloads per file, however, since the 
  62. counter length is configurable, you could get counters in the 65000 range
  63. if you wanted.
  64.  
  65. Usage
  66. -----
  67.    DLC [ /?] [/Q] [/F] [/U] [/I[AreaName]] [/A[AreaName]] [/C<ConfigFile>]
  68.  
  69. Switches
  70. --------
  71.    /?
  72.  
  73.       Display a help screen.
  74.  
  75.    /Q
  76.  
  77.       Quit mode, no screen log echos (but still a brief progress note).
  78.  
  79.    /F
  80.  
  81.       Process all downloads in the BBS and mailer logs even if they have
  82.       been processed already.
  83.  
  84.    /U
  85.  
  86.       Initalizes all areas which allow uploads, however no log parsing is
  87.       performed.  You could use this switch after each upload to your
  88.       system.
  89.  
  90.    /I[AreaName]
  91.  
  92.       DLC will add a zero count to every file without a count located in
  93.       either the file FILES.BBS in the DOWNLOAD directory, or the file
  94.       specified in the FILELIST option.  If a counter does not exist, one
  95.       will be added.  This is NOT a reset for counters.  If just /I is
  96.       used, then all areas will be initalized.  If the optional area
  97.       name is also specified, then only that area will be initialized.
  98.       If the area specified does not exist, no areas will be initialized.
  99.       When this switch is used, only the initialization will be done
  100.       and the log files (both BBS and Mailer) will NOT be parsed.
  101.  
  102.       For example:
  103.  
  104.          DLC /I47             will initialize the area called 47
  105.          DLC /IDOSUTILS       will initialize the area called DOSUTILS
  106.     
  107.    /A[AreaName]
  108.  
  109.       Same as /I except DLC will also parse the mailer logs.
  110.  
  111.    /C<ConfigFile>
  112.  
  113.       The default control file is DLC.CTL, but you can specify an alternate
  114.       control file with this switch.
  115.  
  116. History
  117. -------
  118. 2.30  Full wide release in SDSMAX.
  119.  
  120. 2.29r Maximum file areas is now 435 instead of 400.
  121.  
  122. 2.29q DLC will now ignore any QW? extensions automagically.
  123.  
  124. 2.29p Ok, listen up!  You can now use the - any where you want and what
  125.       is suppose to happen is most likely what may happen.  That is,
  126.       You can use the - in a filename within the FILES.BBS and you can
  127.       use a - in the path of a download area.  And you can use the - as
  128.       a colour indicator as the first character in the FILES.BBS.
  129.       Happy now?
  130.  
  131. 2.29o Another one that looks funny.
  132.  
  133. 2.29n Added - back as a "no-no" character for file names and full
  134.       paths.  - is necessary as a colour control character in the 
  135.       FILES.BBS.  Sorry Ken.  Fixed 'IgnoreFilesWithTic' which never
  136.       did work.
  137.  
  138. 2.29m Improved update performance with a little optimization.  Removed
  139.       the - character from the list of "no-no" characters (I was saving
  140.       it for future switches in the files' description but too many
  141.       want it in the filename and area paths, so now you can).
  142.  
  143. 2.29l There is none, 2.29l looks funny.
  144.  
  145. 2.29k Fixed *MAJOR* bug introduced with 2.29j that would truncate the
  146.       FILES.BBS (or equivalent) after a match is found.  Fixed a small
  147.       bug with the display of the +End log line when /? is used.
  148.  
  149. 2.29j Will exit the current FILES.BBS (or equivalent) as soon as a match
  150.       is found and will *not* search and update dups in the list.
  151.  
  152. 2.29i Fixed a bug that would update a file more than once if more than
  153.       one file area pointed to the same directory.  Sorted areas in memory
  154.       for faster searching.
  155.  
  156. 2.29h Screen writes are now BIOS and not direct, fixed a spelling error
  157.       in the help screen.  Fixed a couple of misplaced file close calls.
  158.       Echo log entries to screen, added /Q for quiet mode.
  159.  
  160. 2.29g Added 'IgnoreFilesWithTic' to allow files that were transferred as
  161.       part of a TIC process to not be counted.  
  162.  
  163. 2.29f Allowed all characters except /-[<{( as the first character of
  164.       a file's description without a counter.  Added /F, forced log
  165.       parsing.
  166.  
  167. 2.29e Added full DOS wildcard matching within FILES.BBS (or equivalent).
  168.       
  169. 2.29d Fixed a bug when the DLC log file directory didn't exist, will now
  170.       catch the error and exit gracefully.  Modified /I to not parse
  171.       log files.  Added /A to initialize AND parse.  Added /U to initialize
  172.       only the upload areas (without log parsing).  Altered the way that DLC
  173.       determines if there is a counter already present.  Now, DLC will check
  174.       to see if a counter is present where it would put one, and not anywhere
  175.       in the line.  This will permit the use of [] (etc) as part of the
  176.       files' description (but not as the first character in the description).
  177.  
  178. 2.29c Fixed a bug when inserting new counters, it would add 3 extra spaces
  179.       when not wanted.
  180.  
  181. 2.29b Added selective area initialization, zero-padded as an option to
  182.       space-padding.  Fixed a bug while reading tab characters.
  183.       Limited beta release.
  184.  
  185. 2.29a Added optional [    ] instead of [   0] for a zero counter.  The 
  186.       length of the counter is now configurable.  DLC will read the current
  187.       counter for a file, update it, and not change the length.  When
  188.       adding a new counter however, DLC will add one in accordance to the
  189.       control file specification for counter length.  Limited beta release.
  190.  
  191. 2.23  Fixed a minor bug which still diplayed an error to the screen when
  192.       the specified FILES.BBS file is not found.  Fixed a bug with lower-
  193.       case specified IgnoreExt.  Added 'AddOrphan' keyword to the control
  194.       file.  Added support for wildcard matching in the FILES.BBS.  Added
  195.       support for same file BBS/Mailer logs (ie. the BBS and Mailer use
  196.       the same log file).
  197.  
  198. 2.22  Fixed a bug that hung on mailer lines with SENT in BBS names,
  199.       took the same problem and fixed it in places that may cause problems
  200.       in similar situations on other log files.  Added support for all
  201.       valid DOS characters in filenames, ie. ~!@#$%&()_
  202.  
  203. 2.21  Fixed a bug that hung on lines with nothing but spaces.
  204.  
  205. 2.2   Added a check to ensure that the DLC will not process entries
  206.       in either the Maximus log file or the mailer log file more than
  207.       once.  This means that you can run DLC on the same log file more
  208.       than once and the downloads will only be counted once.  Added a
  209.       log file, including a log entry level.  Most of output is through
  210.       the log file and not the screen.  Released for testing only.
  211.  
  212. 2.1   Added mailer support, as well as the ability to ignore files
  213.       based on extension.  Changed from a command line configuration
  214.       to a control file configuration.  Name changed from DLCOUNT to
  215.       DLC to avoid copyright infringement.  Released for testing only.
  216.  
  217. 2.0   Rewrite of previous version with better algorithms.  File
  218.       area data is kept in memory and not in a temp file.  Support
  219.       for the FILELIST command in the FILEAREA.CTL was added.
  220.       Colour was an option but then abondoned (too annoying).
  221.       Released for testing only.
  222.  
  223. 1.3   First public release.
  224.  
  225. 1.0   Stone age thing not worth mentioning.
  226.  
  227. Warning!
  228. --------
  229. This utility is not guaranteed to do anything.  Use at your own risk.
  230. Don't come crying to me!
  231.  
  232. Legal Stuff
  233. -----------
  234. This utility may be distributed in it's original archive only.  No fee shall
  235. be charged for its distribution beyond the cost of transmition over phone
  236. lines.
  237.  
  238. Thanks
  239. ------
  240. Much thanks to Chris Grainger (1:163/518) for his help in testing and
  241. support.  Thanks to Ken Wilson (1:243/12) for picking up DLC and 
  242. proposing many excellent suggestions.  Many thanks to all those who 
  243. use this utility and respond with complaints, comments and suggestions.
  244.  
  245.