home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DLC_248.ZIP / DLC.DOC < prev    next >
Encoding:
Text File  |  1993-04-21  |  12.8 KB  |  295 lines
  1. DLC * A Maximus-CBCS v2.01wb Download Counter, Version 2.48
  2. Copyright (C) 1991-1993 Robert Presland, all rights reserved.
  3.  
  4. [ Release Info * 21 Apr 93 ]---------------------------------------------------
  5.  
  6. Release 2.21 and greater are major upgrades from previous releases, therefore
  7. you should read this file before using.  Previous releases were under the
  8. name DLCOUNT but since a utility already existed by that name, mine was
  9. changed to DLC.
  10.  
  11. This version uses a control file for it's parameters (you can only fit
  12. so much on a command line).  Please consult the distribution control
  13. file DLC.CTL for more details.
  14.  
  15. [ Bug Reports ]----------------------------------------------------------------
  16.  
  17. Send bug reports to Robert Presland at 1:243/27, include the following:
  18.  
  19.    DLC.CTL
  20.    DLC.LOG
  21.    DLC.TMP (if found in the current directory)
  22.    AREA.DAT (or equivalent)
  23.    MAX.LOG (or equivalent)
  24.    FD.LOG (if applicable)
  25.    BINK.LOG (if applicable)
  26.    FILES.BBS (if applicable)
  27.  
  28. Zip 'em up and send 'em off.  Many thanks to all that send me reports on
  29. my programs, it's a great help.  I welcome all comments and suggestions
  30. to the above node address.
  31.  
  32. [ So Why Use This Utility? ]---------------------------------------------------
  33.  
  34. DLC currently supports FILELIST for CD-ROM users, mailer logs, extension
  35. exclusions, configurable counter delimiters, optional download log file,
  36. optional log file, multiple configuration files, configurable length
  37. counters, optional 'space for zero' counter, selective initialization,
  38. and will not process the same downloaded file more than once, as well as
  39. much much more.  Read the history section for a complete detailing of
  40. what has been added since the first release.
  41.  
  42. [ Archive ]--------------------------------------------------------------------
  43.  
  44. You should have received DLC in an ARJ archive, with only the following
  45. five (5) files contained within:
  46.  
  47.      DLC.DOC      This text file
  48.      DLC.EXE      The exectuable
  49.      DLCTT.DOC    Documentation for DLCTT
  50.      DLCTT.EXE    The DLCTT executable
  51.      DLC.CTL      The control file for both DLC and DLCTT
  52.  
  53. If one of these files is missing, or there are extra files, or the archive
  54. fails a CRC check, please file-request it from 1:243/27.
  55.  
  56. [ Description ]----------------------------------------------------------------
  57.  
  58. DLC will process your Max log file and add a counter to the beginning
  59. of the description for each file downloaded.  A four digit counter is used
  60. (by default) to enable up to 9999 downloads per file, however, since the 
  61. counter length is configurable, you could get counters in the 65000 range
  62. if you wanted.
  63.  
  64. [ Installation ]---------------------------------------------------------------
  65.  
  66. Simply run DLC as part of your daily maintenace (usually at midnight) and
  67. make sure you configure the control file to suit your system.  After that,
  68. it's all automatic.  Do whatever you want with the logs after DLC is done.
  69.  
  70. [ Usage ]----------------------------------------------------------------------
  71.  
  72.    DLC [ /?] [/F] [/U] [/S] [/C<ConfigFile>] [/I [Areas]] [/A [Areas]]
  73.  
  74. [ Switches ]-------------------------------------------------------------------
  75.  
  76.    /?
  77.  
  78.       Display a help screen.
  79.  
  80.    /F
  81.  
  82.       Process all downloads in the BBS and mailer logs even if they have
  83.       been processed already.
  84.  
  85.    /U
  86.  
  87.       Initalizes all areas which allow uploads, however no log parsing is
  88.       performed.  You could use this switch after each upload to your
  89.       system.
  90.  
  91.    /S
  92.  
  93.       Create a stat file for use with the accompanying program DLCTT.
  94.  
  95.    /I [Areas]
  96.  
  97.       DLC will add a zero count to every file without a count located in
  98.       either the file FILES.BBS in the DOWNLOAD directory, or the file
  99.       specified in the FILELIST option.  If a counter does not exist, one
  100.       will be added.  This is NOT a reset for counters.  If just /I is
  101.       used, then all areas will be initalized.  If a list of area
  102.       names is also specified, then only those areas will be initialized.
  103.       When this switch is used, only the initialization will be done
  104.       and the log files (both BBS and Mailer) will NOT be parsed.
  105.       THIS SWITCH IF SPECIFIED MUST BE THE LAST SWITCH ON THE COMMAND LINE!
  106.  
  107.       For example:
  108.  
  109.          DLC /I                Initialize all areas
  110.          DLC /I 47             Initialize the area 47
  111.          DLC /I DOS GRAPHICS   Initialize the areas DOS and GRAPHICS
  112.     
  113.    /A [Areas]
  114.  
  115.       Same as /I except DLC will also parse the mailer logs.
  116.       THIS SWITCH IF SPECIFIED MUST BE THE LAST SWITCH ON THE COMMAND LINE!
  117.  
  118.    /C<ConfigFile>
  119.  
  120.       The default control file is DLC.CTL, but you can specify an alternate
  121.       control file with this switch.
  122.  
  123. [ History ]--------------------------------------------------------------------
  124.  
  125. 2.48  Fixed a bug that would not find a wildcard match for a filename if
  126.       FileList was being used in a different directory than the files.
  127.       Added LogFile back into the config file.
  128.  
  129. 2.47  Rewrote logic for looking for existing counters and where to put new
  130.       ones.  Should eliminate problems like (1 [  0] of 6) descriptions.
  131.  
  132. 2.46  Added IgnoreMatch.  Changed copyright notice.
  133.  
  134. 2.45  Added text file buffers for increased speed. Removed the logging --
  135.       will not log to the screen, use > to create a log file.  Removed /Q.
  136.       Fixed a bug that would sometimes not add a counter if too many spaces
  137.       were on there line and a counter was added to the previous line (or
  138.       something like that -- point is it's fixed).
  139.  
  140. 2.44  Fixed a bug when using /I alone, will now init all areas (same with /A).
  141.       Fixed a bug that would not recognize the last area specified with /A.
  142.  
  143. 2.43  Added multiple area intialization through /I and /A.
  144.  
  145. 2.42  A little optimization (I tried).  Fixed a bug when assuming data in
  146.       the AREA.DAT file was in parsed format.
  147.  
  148. 2.41  Added 'ProcessGif' and 'GifTemplate' to control file.  See the
  149.       distribution control file for more details.
  150.  
  151. 2.40  Added support for Max's AREA.DAT file.  Reviewed log levels and
  152.       log entries.  Added ": Read x file area(s)" to log.  Added file sharing,
  153.       files are opened in ReadOnly and DenyNone for reading.  DLC will
  154.       now read all areas into memory from AREA.DAT file, maximum 1024
  155.       areas memory permitting.  If DLC can't fit all the areas into memory
  156.       then the remaining areas will just be treated as if they didn't exist.
  157.       Updated DLCTT, see its documentation for more details.
  158.  
  159. 2.33  Fixed a small bug that would occasionaly miss initializing a file
  160.       if it had no description.  Fixed a runtime error when not using /S.
  161.  
  162. 2.32  Added /S and DLCTT.  Deleted beta release notice in docs.  Added
  163.       accompanying utility DLCTT.  See DLCTT.DOC for more details.
  164.  
  165. 2.31  Fixed a bug which would process the same file more than once in
  166.       the mailer log.
  167.  
  168. 2.30  Full wide release in SDSMAX.
  169.  
  170. 2.29r Maximum file areas is now 435 instead of 400.
  171.  
  172. 2.29q DLC will now ignore any QW? extensions automagically.
  173.  
  174. 2.29p Ok, listen up!  You can now use the - any where you want and what
  175.       is suppose to happen is most likely what may happen.  That is,
  176.       You can use the - in a filename within the FILES.BBS and you can
  177.       use a - in the path of a download area.  And you can use the - as
  178.       a colour indicator as the first character in the FILES.BBS.
  179.       Happy now?
  180.  
  181. 2.29o Another one that looks funny.
  182.  
  183. 2.29n Added - back as a "no-no" character for file names and full
  184.       paths.  - is necessary as a colour control character in the 
  185.       FILES.BBS.  Sorry Ken.  Fixed 'IgnoreFilesWithTic' which never
  186.       did work.
  187.  
  188. 2.29m Improved update performance with a little optimization.  Removed
  189.       the - character from the list of "no-no" characters (I was saving
  190.       it for future switches in the files' description but too many
  191.       want it in the filename and area paths, so now you can).
  192.  
  193. 2.29l There is none, 2.29l looks funny.
  194.  
  195. 2.29k Fixed *MAJOR* bug introduced with 2.29j that would truncate the
  196.       FILES.BBS (or equivalent) after a match is found.  Fixed a small
  197.       bug with the display of the +End log line when /? is used.
  198.  
  199. 2.29j Will exit the current FILES.BBS (or equivalent) as soon as a match
  200.       is found and will *not* search and update dups in the list.
  201.  
  202. 2.29i Fixed a bug that would update a file more than once if more than
  203.       one file area pointed to the same directory.  Sorted areas in memory
  204.       for faster searching.
  205.  
  206. 2.29h Screen writes are now BIOS and not direct, fixed a spelling error
  207.       in the help screen.  Fixed a couple of misplaced file close calls.
  208.       Echo log entries to screen, added /Q for quiet mode.
  209.  
  210. 2.29g Added 'IgnoreFilesWithTic' to allow files that were transferred as
  211.       part of a TIC process to not be counted.  
  212.  
  213. 2.29f Allowed all characters except /-[<{( as the first character of
  214.       a file's description without a counter.  Added /F, forced log
  215.       parsing.
  216.  
  217. 2.29e Added full DOS wildcard matching within FILES.BBS (or equivalent).
  218.       
  219. 2.29d Fixed a bug when the DLC log file directory didn't exist, will now
  220.       catch the error and exit gracefully.  Modified /I to not parse
  221.       log files.  Added /A to initialize AND parse.  Added /U to initialize
  222.       only the upload areas (without log parsing).  Altered the way that DLC
  223.       determines if there is a counter already present.  Now, DLC will check
  224.       to see if a counter is present where it would put one, and not anywhere
  225.       in the line.  This will permit the use of [] (etc) as part of the
  226.       files' description (but not as the first character in the description).
  227.  
  228. 2.29c Fixed a bug when inserting new counters, it would add 3 extra spaces
  229.       when not wanted.
  230.  
  231. 2.29b Added selective area initialization, zero-padded as an option to
  232.       space-padding.  Fixed a bug while reading tab characters.
  233.       Limited beta release.
  234.  
  235. 2.29a Added optional [    ] instead of [   0] for a zero counter.  The 
  236.       length of the counter is now configurable.  DLC will read the current
  237.       counter for a file, update it, and not change the length.  When
  238.       adding a new counter however, DLC will add one in accordance to the
  239.       control file specification for counter length.  Limited beta release.
  240.  
  241. 2.23  Fixed a minor bug which still diplayed an error to the screen when
  242.       the specified FILES.BBS file is not found.  Fixed a bug with lower-
  243.       case specified IgnoreExt.  Added 'AddOrphan' keyword to the control
  244.       file.  Added support for wildcard matching in the FILES.BBS.  Added
  245.       support for same file BBS/Mailer logs (ie. the BBS and Mailer use
  246.       the same log file).
  247.  
  248. 2.22  Fixed a bug that hung on mailer lines with SENT in BBS names,
  249.       took the same problem and fixed it in places that may cause problems
  250.       in similar situations on other log files.  Added support for all
  251.       valid DOS characters in filenames, ie. ~!@#$%&()_
  252.  
  253. 2.21  Fixed a bug that hung on lines with nothing but spaces.
  254.  
  255. 2.2   Added a check to ensure that the DLC will not process entries
  256.       in either the Maximus log file or the mailer log file more than
  257.       once.  This means that you can run DLC on the same log file more
  258.       than once and the downloads will only be counted once.  Added a
  259.       log file, including a log entry level.  Most of output is through
  260.       the log file and not the screen.  Released for testing only.
  261.  
  262. 2.1   Added mailer support, as well as the ability to ignore files
  263.       based on extension.  Changed from a command line configuration
  264.       to a control file configuration.  Name changed from DLCOUNT to
  265.       DLC to avoid copyright infringement.  Released for testing only.
  266.  
  267. 2.0   Rewrite of previous version with better algorithms.  File
  268.       area data is kept in memory and not in a temp file.  Support
  269.       for the FILELIST command in the FILEAREA.CTL was added.
  270.       Colour was an option but then abondoned (too annoying).
  271.       Released for testing only.
  272.  
  273. 1.3   First public release.
  274.  
  275. 1.0   Stone age thing not worth mentioning.
  276.  
  277. [ Warning! ]-------------------------------------------------------------------
  278.  
  279. This utility is not guaranteed to do anything.  Use at your own risk.
  280. Don't come crying to me!
  281.  
  282. [ Legal Stuff ]----------------------------------------------------------------
  283.  
  284. This utility may be distributed in it's original archive only.  No fee shall
  285. be charged for its distribution beyond the cost of transmition over phone
  286. lines.
  287.  
  288. [ Thanks ]---------------------------------------------------------------------
  289.  
  290. Much thanks to Chris Grainger (1:163/518) for his help in testing and
  291. support.  Thanks to Ken Wilson (1:243/12) for picking up DLC and 
  292. proposing many excellent suggestions and endless hours of testing.
  293. Many thanks to all those who use this utility and respond with complaints,
  294. comments and suggestions.
  295.