home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / dircnt12.arj / DIRCOUNT.DOC < prev    next >
Encoding:
Text File  |  1992-02-05  |  8.2 KB  |  227 lines
  1.  
  2.  
  3.                          DirCount 1.2, 02-05-92
  4.                               DIRCNT11.ZIP
  5.  
  6.                       File Directory Header Utility
  7.  
  8.  
  9.                    Copyright 1988, 1992 Samuel H. Smith
  10.  
  11.  
  12.                          From The Tool Shop BBS
  13.  
  14.                    Phone number         Modem type
  15.                   --------------    ---------------------
  16.                   (818) 891-3772    US Robotics HST 9600
  17.                   (818) 891-1344    Hayes-V series 9600
  18.                   (818) 891-6780    US Robotics 2400 (free line)
  19.  
  20.  
  21.  
  22.                 What?  Not another directory header utility!
  23.  
  24.         This one is lean and fast.
  25.         You get source code so you can change it if you want.
  26.  
  27.  
  28.         DirCount will scan each file directory listing and insert a header
  29.         that lists the number of files and megabytes used by them.
  30.  
  31.         DirCount also generates a summary of all your file listings.
  32.  
  33.  
  34.  
  35.  
  36.                                   USAGE
  37.                                   =====
  38.  
  39.         DirCount  CONFIGFILE  >SUMMARYFILE
  40.  
  41.  
  42.         CONFIGFILE
  43.                 Specifies the configuration file
  44.  
  45.         >SUMMARYFILE
  46.                 Routes the directory summary to the specified file
  47.                 (usually one of your bulletins)
  48.  
  49.  
  50.         Example:
  51.                 DirCount dircount.cnf >c:\pcb\gen\blt14
  52.  
  53.  
  54.  
  55. Configuration file format:
  56.  
  57.         Line 1.   The main title for each file directory.
  58.                   Usually the name of your board.
  59.  
  60.         Line 2.   The full filename of the first DIR file
  61.         Line 3.   The subtitle for the first DIR file
  62.  
  63.         Line 4.   The full filename of the next DIR file
  64.         Line 5.   The subtitle for the next DIR file
  65.         ...
  66.  
  67.  
  68. Sample Configuration File:
  69.  
  70.    The Tool Shop: Specializing in Software Tools
  71.    C:\PCB\GEN\DIR1
  72.    The Tool Box - ProDoor and Sysop Utilities
  73.    C:\PCB\GEN\DIR2
  74.    Library Source Files
  75.    C:\PCB\GEN\DIR3
  76.    General Utilities
  77.    C:\PCB\GEN\DIR4
  78.    Unix and C Language
  79.    C:\PCB\GEN\DIR5
  80.    Pascal Language
  81.    C:\PCB\GEN\DIR6
  82.    Assembly Language
  83.    C:\PCB\GEN\DIR7
  84.    Other Languages
  85.    C:\PCB\GEN\DIR8
  86.    Communication Utilities
  87.    C:\PCB\GEN\DIR9
  88.    On the Lite Side
  89.    C:\PCB\GEN\DIR10
  90.    Artificial Intelligence
  91.    C:\PCB\GEN\DIR11
  92.    Atari ST and 68000
  93.    C:\PCB\GEN\DIR12
  94.    BBS and Sysop Utilities
  95.    C:\PCB\GEN\DIR13
  96.    Files in this area are deleted as space is needed
  97.    C:\PCB\MAIN\DIR14
  98.    Recent Uploads - Thanks!
  99.  
  100.  
  101. Sample Directory Summary:
  102.  
  103.                 The Tool Shop: Specializing in Software Tools
  104.  
  105.  Dir   Files      Bytes                       Description
  106. ----- ------- -------------  ----------------------------------------------
  107.    1      40      2.44 megs   Tool Shop DOOR and BBS utilities
  108.    2     109      0.43 megs   Tool Shop Library source code
  109.    3      67      5.26 megs   Old versions of Tool Shop utilities
  110.    4     202      3.09 megs   Other programs by Samuel Smith
  111. ...
  112.   74       9      0.53 megs   CPU-CP/M and other 8 bit machines
  113.   75       4      0.08 megs   CPU-All other machine types
  114.   77      83      4.24 megs   Uncategorized files
  115.   78      54      5.31 megs   Old versions and other files soon to be deleted
  116.   79      18      1.64 megs   Files for Tool Shop BOOSTERS Only
  117.   80   1,061     84.94 megs   Recent Uploads.  Thanks!
  118.       ======= ===============
  119.        9,389    557.05 megs
  120.  
  121.  
  122. Sample Dir Listing:
  123.  
  124.                 The Tool Shop: Specializing in Software Tools
  125.  
  126.                        Other programs by Samuel Smith
  127.                           202 files using 3.09 megs
  128.  
  129.  File Name      Size     Date                  File Description
  130. ------------  -------  --------  ---------------------------------------------
  131.  
  132. A3.ZIP          55268  09-18-86  YACC grammar and scanner for ADA
  133. ADAYACC.ZIP    131076  09-25-86  Working YACC grammar and scanner for ADA
  134. AIM.ZIP         38819  02-23-87  Automatic Investment Management / C
  135. ANSTOTXT.ZIP     1036  05-24-87  Convert ANSI into plain text (used here)
  136. CAM10.ZIP       18981  09-08-87  Camelion Language: mimics other languages
  137. CHMOD.ZIP        2396  05-06-86  Change file modes/attributes
  138. CLOCK.ZIP         931  08-19-86  J/ADA System clock package
  139. DERMON11.ZIP    10416  05-01-90  Disk Error Monitor utility
  140.  | TSR utility to monitor disk activity and record last 50 errors in
  141.  | memory for later reporting.  Catches errors that DOS silently corrects.
  142.  | Includes MASM source code.  V1.1 no longer needs to be loaded "last".
  143. DTST20.ZIP      19462  05-06-90  Disk Test 2.0-- Measures time to read each
  144.  | cluster on disk and reports "slow" blocks which are likely to be
  145.  | marginal. With C source code.  Now works with >32MEG partitions.
  146. ESS.ZIP         41723  10-16-85  Expert System Shell / TPAS source
  147. EZSPEL14.ZIP    55841  04-25-89  EZ-Spell.  Updated spelling checker.
  148.  | Now displays unknown words in the context they were found.
  149.  | Use it with DELUXE/Qmail.
  150. FATAL14.ZIP     18005  04-22-90  Replacement for Abort/Retry/Ignore
  151.  | Has shorter automatic retry delays, handles nested COMMAND.COM,
  152.  | and includes new option to zero error counters.
  153. UNZIP20.ZIP     46231  09-09-89  NEW! Zipfile UN-ZIP utility with source code
  154.  | This is intended to be a starter kit for porting UNZIP to non-ibm
  155.  | systems.  Includes source code in both C and Pascal.
  156.  | Now supports PKZ101 format "implode" compression format.
  157. ZIPTV21.ZIP     41944  05-06-90  ZIP text-view cmd for PCBVIEW/ProDoor
  158.  | Uses ZIP Text-View functions of ProDoor.
  159.  | Adds -M option to limit amount of text viewing allowed.
  160.  | Corrects local operation under PCBOARD.EXE.
  161.  | Better error checking to prevent lockups with truncated ZIP files.
  162.  
  163.  
  164.                                        LICENSE
  165.                                        =======
  166.    SourceWare: What is it?
  167.    -----------------------
  168.  
  169.    SourceWare is my name for a unique concept in user supported software.
  170.  
  171.    Programs distributed under the SourceWare concept always offer source
  172.    code.
  173.  
  174.    This package can be freely distributed so long as it is not modified or
  175.    sold for profit.  If you find that this program is valuable, you can
  176.    send me a donation for what you think it is worth.  I suggest about $10.
  177.  
  178.    Send your voluntary contributions to:
  179.          Samuel H. Smith
  180.          The Tool Shop
  181.          P. O. Box 4808
  182.          Panorama City, CA 91412-4808
  183.  
  184.  
  185.    Why SourceWare?
  186.    ---------------
  187.    Why do I offer source code?  Why isn't the donation manditory?  The
  188.    value of good software should be self-evident.  The source code is the
  189.    key to complete understanding of a program.  You can read it to find out
  190.    how things are done.  You can also change it to suit your needs, so long
  191.    as you do not distribute the modified version without my consent.
  192.  
  193.  
  194.    Copyright
  195.    ---------
  196.    If you modify this program,  I would appreciate a copy of the new source
  197.    code.  I am holding the copyright on the source code,  so please don't
  198.    delete my name from the program files or from the documentation.
  199.  
  200.  
  201.                                 DISCLAIMER
  202.                                 ==========
  203.    I make no warranty of any kind, express or implied, including without
  204.    limitation, any warranties of merchantability and/or fitness for a
  205.    particular purpose.  I shall not be liable for any damages, whether
  206.    direct, indirect, special or consequential arising from a failure of
  207.    this program to operate in the manner desired by the user.  I shall not
  208.    be liable for any damage to data or property which may be caused
  209.    directly or indirectly by the use of this program.
  210.  
  211.    IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST
  212.    PROFITS,  LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
  213.    ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
  214.    CLAIM BY ANY OTHER PARTY.
  215.  
  216.                                 Revision History
  217.                                 ================
  218. 12-30-88 v1.0
  219.    Initial release.
  220.  
  221. 07-24-91 v1.1
  222.    Changed output formatting to use bytes, k bytes or megabytes according
  223.    to the actual numeric values for a more readable output.
  224.  
  225. 02-05-92 v1.2
  226.    Changed output formatting to report all file size totals in megabytes.
  227.