home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / DIRCNT16.ZIP / DIRCOUNT.DOC < prev    next >
Text File  |  1993-09-07  |  11KB  |  287 lines
  1.  
  2.  
  3.                          DirCount 1.6, 09-07-93
  4.                               DIRCNT16.ZIP
  5.  
  6.                      File Directory Header Utility
  7.  
  8.  
  9.                          Public Domain Material
  10.                                    by
  11.                             Samuel H. Smith
  12.  
  13.  
  14.                          From The Tool Shop BBS
  15.  
  16.               Phone number             Modem type
  17.            --------------    -------------------------------
  18.            (818) 891-3772    US Robotics HST 9600
  19.            (818) 891-1344    v.32bis 14400 (five line rotary)
  20.            (818) 891-6780    v.32bis 14400 (free line)
  21.  
  22.  
  23.  
  24.         What?  Not another directory header utility!
  25.  
  26.         This one is lean and fast.
  27.         You get source code so you can change it if you want.
  28.  
  29.         DirCount will scan each file directory listing and insert a header
  30.         that lists the number of files and megabytes used by them.
  31.  
  32.         DirCount also generates a summary of all your file listings.
  33.  
  34.         DirSum generates a summary of multiple conferences.
  35.  
  36.         DirOv generates a shortened summary of areas in a single conference.
  37.  
  38.  
  39.  
  40.                                   USAGE
  41.                                   =====
  42.  
  43.         DirCount  CONFIGFILE  >SUMMARYFILE
  44.  
  45.         CONFIGFILE
  46.                 Specifies the configuration file
  47.  
  48.         >SUMMARYFILE
  49.                 Routes the directory summary to the specified file
  50.                 (usually one of your bulletins)
  51.  
  52.         Example:
  53.                 DirCount dircount.cnf >c:\pcb\gen\dir
  54.                 DirCount gifcount.cnf >c:\pcb\adult\dir
  55.                 DirCount boostcnt.cnf >c:\pcb\boosters\dir
  56.  
  57.  
  58.         DirSum SUMMARY1 SUMMARY2 SUMMARY3 >REPORTFILE
  59.  
  60.         SUMMARY1
  61.         SUMMARY2
  62.         SUMMARY3
  63.                 Specifies any number of summaries generated by DIRCOUNT.
  64.  
  65.         >REPORTFILE
  66.                 Routes the report of all summary files to the specified
  67.                 file (usually one of your bulletins)
  68.  
  69.         Example:
  70.                 DirSum c:\pcb\gen\dir c:\pcb\adult\dir c:\pcb\boosters\dir >c:\pcb\gen\blt19
  71.  
  72.  
  73.         DirOV SUMMARY1 MAXDESC >REPORTFILE
  74.  
  75.         SUMMARY1
  76.                 Specifies the summary generated by DIRCOUNT.
  77.  
  78.         MAXDESC
  79.                 Specifies the maximum width of area descriptions to
  80.                 preserve.
  81.  
  82.         >REPORTFILE
  83.                 Routes the report of all summary files to the specified
  84.                 file (usually one of your bulletins)
  85.  
  86.         Example:
  87.                 DirOV c:\pcb\gen\dir 15 | col 19 4 >c:\pcb\gen\blt20
  88.  
  89.  
  90. Configuration file format:
  91.  
  92.         Line 1.   The main title for each file directory.
  93.                   Usually the name of your board.
  94.  
  95.         Line 2.   The subtitle for the directory summary report.
  96.  
  97.         Line 3.   The full filename of the first DIR file
  98.         Line 4.   The subtitle for the first DIR file
  99.  
  100.         Line 5.   The full filename of the next DIR file
  101.         Line 6.   The subtitle for the next DIR file
  102.         ...
  103.  
  104.  
  105. Sample Configuration File:
  106.  
  107.    The Tool Shop: Specializing in Software Tools
  108.    [MAIN BOARD FILE AREAS]
  109.    C:\PCB\GEN\DIR1
  110.    The Tool Box - ProDoor and Sysop Utilities
  111.    C:\PCB\GEN\DIR2
  112.    Library Source Files
  113.    C:\PCB\GEN\DIR3
  114.    General Utilities
  115.    C:\PCB\GEN\DIR4
  116.    Unix and C Language
  117.    C:\PCB\GEN\DIR5
  118.    Pascal Language
  119.    C:\PCB\GEN\DIR6
  120.    Assembly Language
  121.    C:\PCB\GEN\DIR7
  122.    Other Languages
  123.    C:\PCB\GEN\DIR8
  124.    Communication Utilities
  125.    C:\PCB\GEN\DIR9
  126.    On the Lite Side
  127.    C:\PCB\GEN\DIR10
  128.    Artificial Intelligence
  129.    C:\PCB\GEN\DIR11
  130.    Atari ST and 68000
  131.    C:\PCB\GEN\DIR12
  132.    BBS and Sysop Utilities
  133.    C:\PCB\GEN\DIR13
  134.    Files in this area are deleted as space is needed
  135.    C:\PCB\MAIN\DIR14
  136.    Recent Uploads - Thanks!
  137.  
  138.  
  139. Sample Directory Summary:
  140.  
  141.                  The Tool Shop: Specializing in Software Tools
  142.                             [MAIN BOARD FILE AREAS]
  143.  
  144.    Area                Description                 Files      File Sizes
  145.   ------  ------------------------------------   --------  ---------------
  146.      1     S.H.Smith-Comm, DOOR & BBS Utils          108        4,560,071
  147.      2 . . S.H.Smith-Library Source.Code . . . . . . 110 . . . . .495,892
  148.      3     S.H.Smith-Older Utilities                  34        1,638,140
  149.      4 . . S.H.Smith-All Other Programs. . . . . . . 204 . . . .2,755,458
  150.      6     BBS-Comm & Terminal Programs              232       17,967,056
  151.      7 . . BBS-Fido.and.Opus Type.BBS. . . . . . . . .17 . . . .2,202,294
  152.      8     BBS-Offline Mail Readers                   44        7,270,050
  153.      9 . . BBS-PCBoard BBS . . . . . . . . . . . . . 130 . . . 11,324,570
  154.     10     BBS-RBBS BBS                               18        2,128,310
  155.     11 . . BBS-Other BBS Programs. . . . . . . . . . 169 . . . 28,175,431
  156. ...
  157.     78 . . Blocked,.Unwanted & Hacked.Files. . . . . 142 . . . . . . . .0
  158.     79     Older Files Soon to be Deleted!             7        2,118,976
  159.     80 . . Recent.Uploads. .Thanks!. . . . . . . . 1,182 . . .188,190,929
  160.           ------------------------------------   --------  ---------------
  161.                                 Overall Totals     9,594      944,513,116
  162.  
  163. Sample Dir Listing:
  164.  
  165.                 The Tool Shop: Specializing in Software Tools
  166.  
  167.                        Other programs by Samuel Smith
  168.                           202 files using 3.09 megs
  169.  
  170.  File Name      Size     Date                  File Description
  171. ------------  -------  --------  ---------------------------------------------
  172.  
  173. CHMOD.ZIP        2396  05-06-86  Change file modes/attributes
  174. CLOCK.ZIP         931  08-19-86  J/ADA System clock package
  175. DERMON11.ZIP    10416  05-01-90  Disk Error Monitor utility
  176.  | TSR utility to monitor disk activity and record last 50 errors in
  177.  | memory for later reporting.  Catches errors that DOS silently corrects.
  178.  | Includes MASM source code.  V1.1 no longer needs to be loaded "last".
  179. EZSPEL14.ZIP    55841  04-25-89  EZ-Spell.  Updated spelling checker.
  180.  | Now displays unknown words in the context they were found.
  181.  | Use it with DELUXE/Qmail.
  182. FATAL14.ZIP     18005  04-22-90  Replacement for Abort/Retry/Ignore
  183.  | Has shorter automatic retry delays, handles nested COMMAND.COM,
  184.  | and includes new option to zero error counters.
  185. UNZIP20.ZIP     46231  09-09-89  NEW! Zipfile UN-ZIP utility with source code
  186.  | This is intended to be a starter kit for porting UNZIP to non-ibm
  187.  | systems.  Includes source code in both C and Pascal.
  188.  | Now supports PKZ101 format "implode" compression format.
  189.  
  190.  
  191. Sample Output of DirSum Utility:
  192.  
  193.                  The Tool Shop: Specializing in Software Tools
  194.                       Overall Summary of Available Files
  195.  
  196.                 Conference                  Areas     Files      File Sizes  
  197.   --------------------------------------   -------  --------  ----------------
  198.  
  199.   MAIN BOARD FILE AREAS                        67     9,594       944,513,116
  200.  
  201.   "BOOSTERS" SUBSCRIBERS ONLY FILE AREAS        2         1               784
  202.  
  203.   ADULT CONFERENCE FILE AREAS                  10     1,755       223,024,080
  204.  
  205.                                            -------  --------  ----------------
  206.                           Overall Totals       79    11,350     1,167,537,980
  207.  
  208.  
  209. Sample Output of DirOV and COL Utilities:
  210.  
  211.   1-S.H.Smith-HS/Li  22-Language-"AI" S  43-Misc-Word Proce  62-Util-ZIP and ot
  212.   2-S.H.Smith-Libra  23-Language-"Assem  44-Util-CD-ROM Uti  63-Util-All Other
  213.   3-S.H.Smith-ProDo  24-Language-"Basic  45-Util-Batch Util  64-Windows-Applica
  214.   4-S.H.Smith-All O  25-Language-"Forth  46-Util-Debugging   65-Windows-Printer
  215.   6-BBS-Comm & Term  26-Language-"Pasca  47-Util-Hard and F  66-Windows-Fonts
  216.   7-BBS-Fido and Op  27-Language-All Ot  48-Util-DOS Utilit  67-Windows-Game Pr
  217.   8-BBS-Offline Mai  29-Mag-Magazine Li  49-Util-File Manag  68-Windows-Program
  218.   9-BBS-PCBoard BBS  30-Mag-Online News  50-Util-Graphics    69-Windows-Various
  219.  10-BBS-RBBS BBS     32-Misc-Business &  51-Util-Keyboard    70-Windows-Wallpap
  220.  11-BBS-Other BBS P  33-Misc-Database    52-Util-Memory      72-CPU-Apple & Mac
  221.  12-BBS-Text, ANSI,  34-Misc-Educationa  53-Util-Menu Progr  73-CPU-Atari, Amig
  222.  13-Graph-Clip Art   35-Misc-Games and   54-Util-Modem Conf  74-CPU-CP/M and Ot
  223.  14-Graph-Animation  36-Misc-Hints, Tip  55-Util-Mouse       75-CPU-All Other M
  224.  15-Graph-GIF Drawi  37-Misc-Programs f  56-Util-Multi-Task  77-Older Uploads [
  225.  16-Graph-GIF Scene  38-Misc-Science, E  57-Util-Networking  78-Blocked, Unwant
  226.  17-Graph-GIF Anima  39-Misc-Music and   58-Util-OS/2        79-Older Files Soo
  227.  18-Graph-GIF Peopl  40-Misc-Religious   59-Util-Printer Ut  80-Recent Uploads.
  228.  20-Language-"C" So  41-Misc-Space/Astr  60-Util-Screen Uti 
  229.  21-Language-"ADA"   42-Misc-Text Files  61-Util-Virus      
  230.  
  231.  
  232.                                 LICENSE
  233.                                 =======
  234.  
  235.    This program has been released to the public domain.  Do what you
  236.    want with it- just don't blame me if it doesn't work right.
  237.  
  238.  
  239.                                 DISCLAIMER
  240.                                 ==========
  241.    I make no warranty of any kind, express or implied, including without
  242.    limitation, any warranties of merchantability and/or fitness for a
  243.    particular purpose.  I shall not be liable for any damages, whether
  244.    direct, indirect, special or consequential arising from a failure of
  245.    this program to operate in the manner desired by the user.  I shall not
  246.    be liable for any damage to data or property which may be caused
  247.    directly or indirectly by the use of this program.
  248.  
  249.    IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST
  250.    PROFITS,  LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
  251.    ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
  252.    CLAIM BY ANY OTHER PARTY.
  253.  
  254.                                 Revision History
  255.                                 ================
  256. 12-30-88 v1.0
  257.    Initial release.
  258.  
  259. 07-24-91 v1.1
  260.    Changed output formatting to use bytes, k bytes or megabytes according
  261.    to the actual numeric values for a more readable output.
  262.  
  263. 02-05-92 v1.2
  264.    Changed output formatting to report all file size totals in megabytes.
  265.  
  266. 07-14-93 v1.4
  267.    Changed output formatting to skip empty file areas, to list sizes in bytes
  268.    and to list area descriptions to the left of file counts and sizes.
  269.    Added better error trapping and speeded execution about 100%.
  270.    Added logic to preserve 'DELETED' type directory entries.
  271.    Released to public domain.
  272.  
  273. 08-07-93 v1.5
  274.    Added '. . .' leaders to every other file area line to make reading
  275.    easier when there are lots of areas.
  276.    Added DIRSUM utility to produce a summary report from multiple
  277.    DIRCOUNT outputs.
  278.  
  279. 08-27-93
  280.    Changed DIRSUM output formatting.
  281.    Changed DIRCOUNT output formatting.
  282.  
  283. 09-07-93
  284.    Added DIROV utility to produce an area overview from DIRCOUNT outputs.
  285.    Added COL utility to format DIROV output into multiple columns.
  286.  
  287.