home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 21 / CD_ASCQ_21_040595.iso / dos / tools / dirtot16 / dirtot.doc next >
Text File  |  1995-02-28  |  67KB  |  1,676 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.      /---------------------------------------------------------------\
  7.      |                                                               |
  8.      |                   DIRTOT - Directory Totals                   |
  9.      |                     Version 1.6  02-27-95                     |
  10.      |            Copyright (C) Quincunx Software 1992-95            |
  11.      |                      All rights reserved                      |
  12.      |                                                               |
  13.      \---------------------------------------------------------------/
  14.  
  15.  
  16.                                   CONTENTS
  17.  
  18.      INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   1
  19.  
  20.      NEW FEATURES IN THIS VERSION  . . . . . . . . . . . . . . . .   2
  21.  
  22.      INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . .   3
  23.  
  24.      OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  25.  
  26.      PRINTING  . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  27.  
  28.      INITIALIZATION FILE . . . . . . . . . . . . . . . . . . . . .   5
  29.  
  30.      PREDEFINED LAYOUTS  . . . . . . . . . . . . . . . . . . . . .   6
  31.  
  32.      COMMAND LINE OPTIONS  . . . . . . . . . . . . . . . . . . . .   7
  33.  
  34.      SETTINGS  . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  35.  
  36.      AUTOMATIC REPORT FORMATTING . . . . . . . . . . . . . . . . .  15
  37.  
  38.      OTHER FEATURES  . . . . . . . . . . . . . . . . . . . . . . .  15
  39.  
  40.      QUESTIONS AND ANSWERS . . . . . . . . . . . . . . . . . . . .  16
  41.  
  42.      TIPS AND TECHNIQUES . . . . . . . . . . . . . . . . . . . . .  19
  43.  
  44.      ERROR MESSAGES  . . . . . . . . . . . . . . . . . . . . . . .  21
  45.  
  46.      SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  47.  
  48.      REGISTRATION  . . . . . . . . . . . . . . . . . . . . . . . .  26
  49.  
  50.      ABOUT QUINCUNX SOFTWARE . . . . . . . . . . . . . . . . . . .  28
  51.  
  52.      INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . .  29
  53.  
  54.      REGISTRATION FORM . . . . . . . . . . . . . . . . . . . . . .  30
  55.  
  56.  
  57.  
  58.  
  59.      DIRTOT                                                     Page 1
  60.  
  61.  
  62.      /---------------------------------------------------------------\
  63.      |                                                               |
  64.      |                          INTRODUCTION                         |
  65.      |                                                               |
  66.      \---------------------------------------------------------------/
  67.  
  68.      DIRTOT (pronounced der-tote) provides a view of the space used on
  69.      your hard disk that you may never have seen before.  It lists the
  70.      total space used by each subdirectory PLUS ALL SUBDIRECTORY
  71.      LEVELS BELOW IT.  It answers questions like "How much space does
  72.      my word processor and all its files use?" or "What program is
  73.      using all my disk space?".  It can help you find places to free
  74.      up space for new programs.
  75.  
  76.      DIRTOT has a customizable report format and numerous options. 
  77.      Its listing can be displayed on the screen, printed, or stored in
  78.      a file.
  79.  
  80.      Suppose you have the following subdirectory structure.  With any
  81.      of several utilities you can find out how much space the files in
  82.      EACH subdirectory use.  (It may take 8 separate commands to do
  83.      so):
  84.  
  85.      \C600                                 0
  86.      \C600\BIN                       1996054
  87.      \C600\BINB                       374879
  88.      \C600\HELP                      2054723
  89.      \C600\INCLUDE                    119121
  90.      \C600\INCLUDE\SYS                  4327
  91.      \C600\INIT                        19217
  92.      \C600\LIB                       1234894
  93.  
  94.      Then with a calculator you can add them up to find that 5803215
  95.      bytes are used by the compiler and its associated files.  With
  96.      DIRTOT you give one command:
  97.  
  98.         dirtot \c600
  99.  
  100.      COMPUADD325                4:12p 07-04-94                30,236,672 Free
  101.      C:\C600                          2 Levels                         Page 1
  102.      Directory     Total Alloc  Total Used   Used       Dirs  Files  Latest  
  103.      ------------  -----------  -----------  ---------  ----  -----  --------
  104.      C600            6,234,112    5,803,215          0     7     88  07-04-94
  105.      ├─BIN           2,088,960    1,996,054  1,996,054           21  11-16-93
  106.      ├─BINB            393,216      374,879    374,879            4  06-14-90
  107.      ├─HELP          2,088,960    2,054,723  2,054,723           10  08-29-90
  108.      ├─INCLUDE         319,488      123,448    119,121     1     35  07-31-90
  109.      │ └─SYS            40,960        4,327      4,327            5  09-27-89
  110.      ├─INIT             24,576       19,217     19,217            3  07-04-94
  111.      └─LIB           1,318,912    1,234,894  1,234,894           15  02-10-92
  112.  
  113.      DIRTOT 1.6 Shareware  (C) 1992-95 Quincunx Software  All rights reserved
  114.      Registered to                 Tom Caswick                  Barneveld, WI
  115.  
  116.  
  117.  
  118.  
  119.      DIRTOT                                                     Page 2
  120.  
  121.  
  122.  
  123.      The first line of the heading shows the Volume ID of the disk
  124.      drive, the time and date the listing was created, and the number
  125.      of bytes free on the disk.  The second heading line shows the
  126.      complete specification of the path you entered on the command
  127.      line, and the maximum number of levels of subdirectories in that
  128.      path.  (In the example C600 is level 0, INCLUDE is at level 1,
  129.      and SYS is at level 2.)
  130.  
  131.      The columns show the Directory names in a tree format, the Total
  132.      space Allocated in clusters to each subdirectory plus all levels
  133.      below it, the Total space Used by each subdirectory plus all
  134.      levels below it, the space Used by each subdirectory
  135.      independently, the total number of subDirectories below each
  136.      directory, the total number of Files in each subdirectory plus
  137.      all levels below it, and the date of the Latest file in each.
  138.  
  139.      In the first line you see that directory C600 and all its
  140.      subdirectories were allocated 6,234,112 bytes, although they
  141.      actually used 5,803,215 bytes.  (The remaining bytes are used in
  142.      system overhead.)  Directory C600 by itself used no space at all. 
  143.      There are 7 subdirectories below this point, and a total of 88
  144.      files in the entire structure.  The most recently changed file in
  145.      this subdirectory structure was changed on 07-04-94.
  146.  
  147.  
  148.      /---------------------------------------------------------------\
  149.      |                                                               |
  150.      |                  NEW FEATURES IN THIS VERSION                 |
  151.      |                                                               |
  152.      \---------------------------------------------------------------/
  153.  
  154.      Version 1.6  2-27-95:
  155.  
  156.         -  Predefined layouts in initialization file
  157.         -  Settings for printer columns and lines per page
  158.         -  Page numbers on printed reports
  159.         -  Usage history
  160.         -  Minor fixes: Get volume ID in OS/2 DOS session, support
  161.            volumes larger than 2 Gigabytes.
  162.  
  163.      Version 1.5  7-24-94:
  164.  
  165.         -  Customizable report format
  166.         -  Automatic report formatting
  167.         -  5 sort orders
  168.         -  Reports total space allocated by clusters
  169.         -  Reports date of most recent file 
  170.         -  Reports total space needing backup
  171.         -  Default settings stored in initialization file
  172.         -  Expanded capacity, over 10,000 subdirectories per drive
  173.         -  Press Esc to cancel at any time
  174.         -  Will not send non-printable characters in directory and
  175.            volume names to the printer
  176.  
  177.  
  178.  
  179.  
  180.      DIRTOT                                                     Page 3
  181.  
  182.  
  183.  
  184.      /---------------------------------------------------------------\
  185.      |                                                               |
  186.      |                          INSTALLATION                         |
  187.      |                                                               |
  188.      \---------------------------------------------------------------/
  189.  
  190.      A runnable copy of DIRTOT consists of the files DIRTOT.EXE,
  191.      DIRTOT.INI, and DIRTOT.REG.  It can be run from wherever it is,
  192.      or you can copy it to your hard disk.  We recommend that you put
  193.      it in a subdirectory with other utilities and which is in the DOS
  194.      PATH.  For example,
  195.  
  196.           copy dirtot.exe c:\utility
  197.           copy dirtot.ini c:\utility
  198.           copy dirtot.reg c:\utility
  199.  
  200.      DIRTOT requires any PC running DOS 3.0 or later.  It has no
  201.      special memory or display requirements.  
  202.  
  203.      If running on a network, the registration data file DIRTOT.REG
  204.      must be in a subdirectory to which you have write access.
  205.  
  206.  
  207.      /---------------------------------------------------------------\
  208.      |                                                               |
  209.      |                           OPERATION                           |
  210.      |                                                               |
  211.      \---------------------------------------------------------------/
  212.  
  213.      DIRTOT is run from the DOS command line.  The command
  214.  
  215.           dirtot
  216.  
  217.      alone will produce a full report of all subdirectories on the
  218.      current drive.  It will pause after each screen; you can press
  219.      any key to continue.
  220.  
  221.      You can specify the drive:
  222.  
  223.           dirtot d:
  224.  
  225.      or you can specify a particular subdirectory:
  226.  
  227.           dirtot c:\wp51
  228.  
  229.      You can also produce multiple reports from a single command:
  230.  
  231.           dirtot \c600 d:\borlandc c:\windows wp51 e:
  232.  
  233.      There are several different predefined report layouts available. 
  234.      (See the Predefined Layouts section for details.)  They are
  235.      specified by name enclosed in brackets [].  To produce a report
  236.      with the largest directories first:
  237.  
  238.  
  239.  
  240.  
  241.      DIRTOT                                                     Page 4
  242.  
  243.  
  244.           dirtot [big]
  245.  
  246.      or to find out how many kilobytes need to be backed up:
  247.  
  248.           dirtot d: [backup]
  249.  
  250.      DIRTOT has numerous options to customize its output.  (See the
  251.      Settings section for details.)  Type your options anywhere on the
  252.      command line.  For a brief listing:
  253.  
  254.           dirtot \c600 /b
  255.  
  256.      For a listing of the first level, indented 4 spaces, in
  257.      kilobytes, sorted by total size, of all subdirectories on drive
  258.      D:
  259.  
  260.           dirtot /l1 /i4 /nk /st d:
  261.  
  262.      Or use the equivalent command:
  263.  
  264.           dirtot /l1i4nkst d:
  265.  
  266.      You can use both predefined layouts and command line options at
  267.      the same time.  To run the "backup" report but with numbers in
  268.      megabytes:
  269.  
  270.           dirtot d: [backup] /nm
  271.  
  272.  
  273.      /---------------------------------------------------------------\
  274.      |                                                               |
  275.      |                            PRINTING                           |
  276.      |                                                               |
  277.      \---------------------------------------------------------------/
  278.  
  279.      To send the output to the printer, use the DOS redirection
  280.      feature:
  281.  
  282.           dirtot c: >prn
  283.  
  284.      DIRTOT detects that its output is not going to the screen, so it
  285.      does NOT pause after each screen full.
  286.  
  287.      Be sure to set your printer for a fixed pitch font so the columns
  288.      will be aligned.
  289.  
  290.      You can also send the output to a file this way, then later
  291.      incorporate the file into some other report:
  292.  
  293.           dirtot c: >c:\wp\reports\c_totals.txt
  294.  
  295.  
  296.  
  297.  
  298.      DIRTOT                                                     Page 5
  299.  
  300.  
  301.      /---------------------------------------------------------------\
  302.      |                                                               |
  303.      |                      INITIALIZATION FILE                      |
  304.      |                                                               |
  305.      \---------------------------------------------------------------/
  306.  
  307.      DIRTOT reads its default settings from the text file DIRTOT.INI. 
  308.      You can edit this file to set normal operation to your
  309.      preferences, then use command line options for temporary changes.
  310.  
  311.      DIRTOT searches for its .INI file in the current directory first,
  312.      then in the directory where DIRTOT.EXE is located.  If DIRTOT.INI
  313.      is not found in either location a warning message is displayed
  314.      and operation continues using internal default settings.
  315.  
  316.      You may use any text editor to change DIRTOT.INI.  For example,
  317.      to use the editor which comes with DOS version 5 and later,
  318.      change to the directory containing DIRTOT.INI and enter the
  319.      command:
  320.  
  321.         edit dirtot.ini
  322.  
  323.      The initialization file format consists of key words followed by
  324.      an equal sign (=) followed by the value.  Key words may be in
  325.      upper, lower or mixed case.  White space is ignored, and
  326.      everything on the line after a semicolon (;) is a comment. 
  327.      Example:
  328.  
  329.           Indent = 2          ; columns to indent each level 
  330.  
  331.      Three types of values are supported:
  332.  
  333.      On/Off -  these are true/false values.  You may enter ON, TRUE,
  334.                or a non-zero number, or OFF, FALSE, or 0.  
  335.                Example: Commas = On
  336.  
  337.      Numbers - these are groups of decimal digits.  
  338.                Example: MaxLevel = 31
  339.  
  340.      Strings - these are groups of any characters enclosed in quotes.
  341.                Example: Format = "NC%TDFB"
  342.  
  343.      Most settings can be done from either the initialization file or
  344.      the command line.  The command line takes precedence.
  345.  
  346.      The first section of the initialization file, up to the first
  347.      line beginning with a bracket [, is the defaults.  After that are
  348.      several sections of Predefined Layouts.
  349.  
  350.  
  351.  
  352.  
  353.      DIRTOT                                                     Page 6
  354.  
  355.  
  356.      /---------------------------------------------------------------\
  357.      |                                                               |
  358.      |                       PREDEFINED LAYOUTS                      |
  359.      |                                                               |
  360.      \---------------------------------------------------------------/
  361.  
  362.      DIRTOT comes with several different report styles set up in its
  363.      initialization file.  You can select one by typing its name on
  364.      the command line, enclosed in brackets [].  The Predefined
  365.      Layouts included with this version are:
  366.  
  367.           [big]          largest directories first, single level
  368.  
  369.           [max]          maximum information DIRTOT can report
  370.  
  371.           [backup]       files needing backup
  372.  
  373.           [latest]       most recently changed first
  374.  
  375.           [alt]          an alternate appearance
  376.  
  377.           [notot]        no totals, a very simple report
  378.  
  379.           [usedfree]     brief list of space used and space free, best
  380.                          used on multiple drives
  381.  
  382.      You can customize these or add your own.  Edit the file
  383.      DIRTOT.INI and look near the end.  Each Predefined Layout section
  384.      begins with a name in brackets, and ends at the next name in
  385.      brackets.  Here are the [big] and [max] Predefined Layouts:
  386.  
  387.           [big]               ; largest first, single level
  388.  
  389.           Format = "NC%T%DF"
  390.           MaxLevel = 1
  391.           Sort = "C"
  392.           NumberFormat = "K"
  393.  
  394.           [max]               ; maximum information available
  395.  
  396.           Format = "NC%AT%UDF%LB%"
  397.           MaxLevel = 31
  398.           Sort = "N"
  399.  
  400.      Notice that only those settings which are different from the
  401.      defaults NEED to be included, but any setting MAY be included. 
  402.      To add a new Predefined Layout just start it with a name in
  403.      brackets and list the settings you want.  Here is how a layout
  404.      named [Mine], like the command line option example in the
  405.      Operation section, could be added:
  406.  
  407.  
  408.  
  409.  
  410.      DIRTOT                                                     Page 7
  411.  
  412.  
  413.           [big]               ; largest first, single level
  414.  
  415.           Format = "NC%T%DF"
  416.           MaxLevel = 1
  417.           Sort = "C"
  418.           NumberFormat = "K"
  419.  
  420.           [Mine]
  421.           maxlevel=1
  422.           indent=4
  423.           numberformat="k"
  424.           sort="t"
  425.  
  426.           [max]               ; maximum information available
  427.  
  428.           Format = "NC%AT%UDF%LB%"
  429.           MaxLevel = 31
  430.           Sort = "N"
  431.  
  432.  
  433.      /---------------------------------------------------------------\
  434.      |                                                               |
  435.      |                      COMMAND LINE OPTIONS                     |
  436.      |                                                               |
  437.      \---------------------------------------------------------------/
  438.  
  439.      Command line options are used to adjust the settings for only one
  440.      run.  You can use the command line to experiment and find your
  441.      preferences, then edit the .INI file to retain your preferences
  442.      for later runs.
  443.  
  444.      Command line options may be preceded by a dash (-) or a
  445.      slash (/), may be entered in upper or lower case, and multiple
  446.      options may be combined in one string.  Options may appear
  447.      anywhere on the command line.  
  448.  
  449.      The initialization file determines the value of options which are
  450.      not explicitly set on the command line.  
  451.  
  452.      On/Off options are turned Off by following the option letter with
  453.      a dash or minus (-).  For example, commas are normally On.  To
  454.      turn commas Off:
  455.  
  456.           dirtot -c-
  457.  
  458.  
  459.  
  460.  
  461.      DIRTOT                                                     Page 8
  462.  
  463.  
  464.  
  465.      /---------------------------------------------------------------\
  466.      |                                                               |
  467.      |                            SETTINGS                           |
  468.      |                                                               |
  469.      \---------------------------------------------------------------/
  470.  
  471.      The values of settings indicated below are those originally in
  472.      the initialization file when it was distributed.  Your settings
  473.      may differ.  The first line of each setting is shown in the
  474.      following format:
  475.  
  476.      Initialization      Command   Description
  477.       file                line
  478.       entry               option
  479.      --------------      -------   ----------------------------------
  480.  
  481.      Ascii = Off         -a        use standard ASCII characters
  482.  
  483.           This setting substitutes the plain characters '+', '-', '|',
  484.           and '\' for the extended graphic characters in the tree
  485.           list.  Also a '?' is substituted for any extended characters
  486.           in directory names.  Its main use is for printing a report
  487.           on a printer that does not support the extended characters.
  488.  
  489.                C600         
  490.                +-BIN        
  491.                +-BINB       
  492.                +-HELP       
  493.                +-INCLUDE    
  494.                | \-SYS      
  495.                +-INIT       
  496.                +-LIB        
  497.                \-SOURCE     
  498.                  +-DOC      
  499.                  \-STARTUP  
  500.                    \-DOS    
  501.  
  502.  
  503.      Brief = Off         -b        Brief output
  504.  
  505.           This setting produces a report with no headings and no
  506.           copyright notice.
  507.  
  508.  
  509.      Commas = On         -c        include Commas in numbers
  510.  
  511.           The 'c' setting causes numbers to be displayed with
  512.           thousands separators.  (This setting may be overridden by
  513.           Automatic Report Formatting.  See that section for details.)
  514.  
  515.  
  516.  
  517.  
  518.      DIRTOT                                                     Page 9
  519.  
  520.  
  521.      Format = "NCTUDFL"  -fxxx     report Format
  522.  
  523.           Enter a list from the following letters:
  524.  
  525.                N -  directory Name in tree format
  526.                C -  total cluster space alloCated for this directory
  527.                     and all children
  528.                T -  Total space used by this directory and all
  529.                     children
  530.                A -  cluster space Allocated for this directory
  531.                U -  space Used by this directory
  532.                D -  number of child Directories
  533.                F -  number of Files in this directory and all children
  534.                L -  date of Latest file in this directory and all
  535.                     children
  536.                B -  total space needing Backup (archive bit set) in
  537.                     this directory and all children
  538.                E -  Extended directory name
  539.                % -  after C, T, F - percent of previous level
  540.                     after B - percent of Total space used
  541.                S -  free Space on the drive, only useful when doing a
  542.                     brief, level 0 report
  543.  
  544.           This setting allows you to totally customize DIRTOT's
  545.           output.  Some examples:
  546.  
  547.               dirtot /fntf \c600
  548.  
  549.           Directory  Total Used   Files
  550.           ---------  -----------  -----
  551.           C600         5,803,186     88
  552.           ├─BIN        1,996,054     21
  553.           ├─BINB         374,879      4
  554.           ├─HELP       2,054,723     10
  555.           ├─INCLUDE      123,448     35
  556.           │ └─SYS          4,327      5
  557.           ├─INIT          19,188      3
  558.           └─LIB        1,234,894     15
  559.  
  560.  
  561.               dirtot /fcabn \c600
  562.  
  563.           Total Alloc  Allocated  Backup  Directory
  564.           -----------  ---------  ------  ---------
  565.             6,234,112          0  23,020  C600     
  566.             2,088,960  2,088,960   3,832  ├─BIN    
  567.               393,216    393,216       0  ├─BINB   
  568.             2,088,960  2,088,960       0  ├─HELP   
  569.               319,488    278,528       0  ├─INCLUDE
  570.                40,960     40,960       0  │ └─SYS  
  571.                24,576     24,576  19,188  ├─INIT   
  572.             1,318,912  1,318,912       0  └─LIB    
  573.  
  574.  
  575.  
  576.  
  577.      DIRTOT                                                    Page 10
  578.  
  579.  
  580.                   dirtot /fncatudflb \c600
  581.  
  582.    Directory Tot Alloc Allocated Tot Used  Used      Dirs Files Latest   Backup
  583.    --------- --------- --------- --------- --------- ---- ----- -------- ------
  584.    C600      6,234,112         0 5,803,186         0    7    88 07-13-94 23,020
  585.    ├─BIN     2,088,960 2,088,960 1,996,054 1,996,054         21 11-16-93  3,832
  586.    ├─BINB      393,216   393,216   374,879   374,879          4 06-14-90      0
  587.    ├─HELP    2,088,960 2,088,960 2,054,723 2,054,723         10 08-29-90      0
  588.    ├─INCLUDE   319,488   278,528   123,448   119,121    1    35 07-31-90      0
  589.    │ └─SYS      40,960    40,960     4,327     4,327          5 09-27-89      0
  590.    ├─INIT       24,576    24,576    19,188    19,188          3 07-13-94 19,188
  591.    └─LIB     1,318,912 1,318,912 1,234,894 1,234,894         15 02-10-92      0
  592.  
  593.  
  594.           Use the following to squeeze the maximum data from DIRTOT. 
  595.           Depending on your disk layout, it may not fit on your
  596.           screen:
  597.  
  598.                dirtot /fnc%at%udf%lb% \c600
  599.  
  600.    Directory TotAlc  %  Alloc  TotUsd  %  Used   D Fi  %  Latest   Bac  % 
  601.    --------- ------ --- ------ ------ --- ------ - -- --- -------- --- ---
  602.    C600      6,088K          0 5,667K          0 7 88     07-13-94 22K  <1
  603.    ├─BIN     2,040K  34 2,040K 1,949K  34 1,949K   21  24 11-16-93  4K  <1
  604.    ├─BINB      384K   6   384K   366K   6   366K    4   5 06-14-90   0   0
  605.    ├─HELP    2,040K  34 2,040K 2,007K  35 2,007K   10  11 08-29-90   0   0
  606.    ├─INCLUDE   312K   5   272K   121K   2   116K 1 35  40 07-31-90   0   0
  607.    │ └─SYS      40K  13    40K     4K   4     4K    5  14 09-27-89   0   0
  608.    ├─INIT       24K  <1    24K    19K  <1    19K    3   3 07-13-94 19K 100
  609.    └─LIB     1,288K  21 1,288K 1,206K  21 1,206K   15  17 02-10-92   0   0
  610.  
  611.  
  612.           For a style different from the tree format, use 'e' instead
  613.           of 'n':
  614.  
  615.               dirtot /feu \c600
  616.  
  617.           Directory            Used     
  618.           -------------------  ---------
  619.           C:\C600                      0
  620.           C:\C600\BIN          1,996,054
  621.           C:\C600\BINB           374,879
  622.           C:\C600\HELP         2,054,723
  623.           C:\C600\INCLUDE        119,121
  624.           C:\C600\INCLUDE\SYS      4,327
  625.           C:\C600\INIT            19,188
  626.           C:\C600\LIB          1,234,894
  627.  
  628.  
  629.  
  630.  
  631.      DIRTOT                                                    Page 11
  632.  
  633.  
  634.           For import into another application you may wish to turn off
  635.           the headings and commas:
  636.  
  637.               dirtot /bc-feu \c600
  638.  
  639.           C:\C600                      0
  640.           C:\C600\BIN            1996054
  641.           C:\C600\BINB            374879
  642.           C:\C600\HELP           2054723
  643.           C:\C600\INCLUDE         119121
  644.           C:\C600\INCLUDE\SYS       4327
  645.           C:\C600\INIT             19188
  646.           C:\C600\LIB            1234894
  647.  
  648.  
  649.           When entered on the command line, the -f option cannot be
  650.           directly followed by other options.  Example:
  651.  
  652.                -fncatudfbi4l2           *** INVALID ***
  653.  
  654.                -fncatudfb -i4l2         OK
  655.  
  656.           See also the section on Automatic Report Formatting.
  657.  
  658.  
  659.      HeadPerPage = On    -h        Heading on each screen or page
  660.  
  661.           This setting displays column headings at the top of each
  662.           screen or page.  If it is set to off, the column headings
  663.           will still appear once at the beginning of the report.
  664.  
  665.  
  666.      Indent = 2          -i##      columns to Indent each level
  667.  
  668.           Enter a number from 0 to 12.  This setting controls the
  669.           appearance of the directory tree listing.  Example:
  670.  
  671.                dirtot -i4 \c600
  672.  
  673.                C600                        
  674.                ├───BIN                     
  675.                ├───BINB                    
  676.                ├───HELP                    
  677.                ├───INCLUDE                 
  678.                │   └───SYS                 
  679.                ├───INIT                    
  680.                ├───LIB                     
  681.                └───SOURCE                  
  682.                    ├───DOC                 
  683.                    └───STARTUP             
  684.                        └───DOS             
  685.  
  686.           (This setting may be overridden by Automatic Report
  687.           Formatting.  See that section for details.)
  688.  
  689.  
  690.  
  691.  
  692.      DIRTOT                                                    Page 12
  693.  
  694.  
  695.  
  696.      MaxLevel = 31       -l##      maximum Levels to show
  697.  
  698.           Enter a number from 0 to 31.  This setting limits the number
  699.           of directory tree levels displayed.  Note that all lower
  700.           levels are scanned and counted regardless of this setting.
  701.  
  702.           Zero shows only one line about the topmost level.  One shows
  703.           only the first level subdirectories, two shows two levels of
  704.           subdirectories, etc.
  705.  
  706.  
  707.      NumberFormat = "B"  -nx       Number format
  708.  
  709.           Enter the letter B, K or M.  This setting causes numbers to
  710.           be displayed in Bytes, in Kilobytes (1024 bytes) rounded to
  711.           the nearest kilobyte, or in Megabytes (1,048,576 bytes)
  712.           rounded to the nearest one-tenth megabyte.  For example
  713.           119,121 shows as 116K or .1M.  (This setting may be
  714.           overridden by Automatic Report Formatting.  See that section
  715.           for details.)
  716.  
  717.  
  718.      Pause = On          -p        Pause each screen full
  719.  
  720.           When the listing appears on the screen, DIRTOT pauses after
  721.           each screen for you to press a key.  Turning this setting
  722.           off causes the output to scroll continuously.  (If the
  723.           output is redirected to the printer or a file DIRTOT does
  724.           not pause regardless of this setting.)
  725.  
  726.  
  727.      Quiet = Off         -q        Quiet mode
  728.  
  729.           This setting eliminates the "Totaling..." and "Printing..."
  730.           displays and the beep in error messages.
  731.  
  732.  
  733.      (n/a)               -r        enter Registration data
  734.  
  735.           Specifying this option causes DIRTOT to ask you for your
  736.           registered name and location, and registration number.  You
  737.           must first obtain a registration number by paying the
  738.           registration fee.  When this option is selected no report is
  739.           produced and any other options are ignored.  See the section
  740.           on Registration for details.
  741.  
  742.  
  743.      Sort = "N"          -sx       Sort order
  744.  
  745.           Enter N, C, T, L, or U.  This setting causes each level of
  746.           subdirectories to be sorted by either directory Name
  747.           (ascending), total space alloCated (descending), Total space
  748.           used (descending), Latest date (descending), or Unsorted.
  749.  
  750.  
  751.  
  752.  
  753.      DIRTOT                                                    Page 13
  754.  
  755.  
  756.  
  757.      Branches = On       -t        Tree branches
  758.  
  759.           Turning this setting off removes the connecting lines in the
  760.           tree display:
  761.  
  762.                C600          
  763.                  BIN         
  764.                  BINB        
  765.                  HELP        
  766.                  INCLUDE     
  767.                    SYS       
  768.                  INIT        
  769.                  LIB         
  770.                  SOURCE      
  771.                    DOC       
  772.                    STARTUP   
  773.                      DOS     
  774.  
  775.  
  776.      (n/a)               -u        Usage history
  777.  
  778.           Specifying this option causes a brief account of your use of
  779.           DIRTOT to be displayed.  When this option is selected no
  780.           report is produced and any other options are ignored. 
  781.  
  782.                Usage History: Run 28 times - In use 37 days
  783.                Month 12-94 01-95 02-95 
  784.                      ----- ----- -----
  785.                Runs     19     7     2
  786.  
  787.           This sample report indicates you have run this copy of
  788.           DIRTOT a total of 28 times - 19 times in December, 7 times
  789.           in January, and 2 times in February.  This copy was first
  790.           used 37 days ago.  This information can be helpful when
  791.           deciding whether DIRTOT is worth registering.  Keep in mind
  792.           that a utility such as DIRTOT is not something you use every
  793.           day.  Using it once a month would be typical.
  794.  
  795.  
  796.      PrintCols = 80      -w        Wide printer (132 columns)
  797.  
  798.           This setting specifies the number of columns your printer
  799.           can print in the current font.  DIRTOT does not send any
  800.           printer set up codes - you should ensure that the printer is
  801.           set up as desired before starting DIRTOT.  Use a fixed pitch
  802.           font to keep the columns aligned.  This setting makes no
  803.           difference for narrower reports.
  804.  
  805.  
  806.  
  807.  
  808.      DIRTOT                                                    Page 14
  809.  
  810.  
  811.      PrintLines = 60     (n/a)     printer lines per page
  812.  
  813.           This setting specifies the number lines to use on each page
  814.           of printed reports.  DIRTOT sends the Form Feed character
  815.           (Hex 0C) to move to the beginning of the next page.
  816.  
  817.  
  818.      ;Columns = 80       (n/a)     screen columns
  819.  
  820.           This setting is normally disabled (commented out) in the
  821.           .INI file, in which case DIRTOT uses the current screen
  822.           width.  It can be used in special situations where DIRTOT
  823.           cannot correctly determine the number of columns on your
  824.           screen.
  825.  
  826.  
  827.      ;Rows = 25          (n/a)     screen rows
  828.  
  829.           This setting is normally disabled (commented out) in the
  830.           .INI file, in which case DIRTOT uses the current screen
  831.           height.  It can be used in special situations where DIRTOT
  832.           cannot correctly determine the number of rows on your
  833.           screen.
  834.  
  835.  
  836.      Path = ""           (n/a)     drives or directories to report
  837.  
  838.           You normally specify the drives and/or directories to report
  839.           on the command line.  If you do not specify any, DIRTOT
  840.           reports on the current drive.  Use this setting if you want
  841.           DIRTOT to always report on a certain list of drives and/or
  842.           directories (when you don't put any on the command line). 
  843.           You may enter multiple drives/directories separated by
  844.           spaces, commas, or semicolons.  Examples:
  845.                path = "C:,D:,E:"
  846.                Path="D:\FRED"
  847.                PATH = "\c600 d:\borlandc c:\windows wp51 e:"
  848.  
  849.  
  850.      (n/a)               -z        display debug output
  851.  
  852.           This option causes the display of internal information only
  853.           useful to the author.
  854.  
  855.  
  856.      (n/a)               -?        show Help info
  857.  
  858.           This displays a help screen listing the command line
  859.           options.
  860.  
  861.  
  862.  
  863.  
  864.      DIRTOT                                                    Page 15
  865.  
  866.  
  867.      /---------------------------------------------------------------\
  868.      |                                                               |
  869.      |                  AUTOMATIC REPORT FORMATTING                  |
  870.      |                                                               |
  871.      \---------------------------------------------------------------/
  872.  
  873.      DIRTOT automatically adjusts the width of its report to fit on
  874.      the screen or printer.  To accomplish this while still providing
  875.      as close as possible to the specific formatting features you
  876.      requested, DIRTOT goes through a sequence of steps, in order,
  877.      until the report fits.  These steps include:
  878.  
  879.         -  reducing the number of levels that are shown fully indented
  880.         -  reducing the number of characters each level is indented
  881.         -  shrinking the titles of some columns
  882.         -  reducing the space between columns
  883.         -  showing numbers in Kilobytes
  884.         -  removing commas
  885.         -  showing numbers in Megabytes
  886.  
  887.      Note that this automatic formatting will sometimes override your
  888.      settings for Indent, Number format, and Commas.
  889.  
  890.  
  891.      /---------------------------------------------------------------\
  892.      |                                                               |
  893.      |                         OTHER FEATURES                        |
  894.      |                                                               |
  895.      \---------------------------------------------------------------/
  896.  
  897.      DIRTOT indicates subdirectories with Hidden or System attributes
  898.      by displaying their names in lower case.
  899.  
  900.      DIRTOT replaces unprintable control characters in directory or
  901.      volume names with a question mark (?).  If the Ascii setting is
  902.      turned on, any extended characters will also be replaced.
  903.  
  904.      DIRTOT adapts to the number of rows and columns on your screen. 
  905.      It will pause after every 25, 43, 50, or other number of lines. 
  906.      It will display a wider report if your screen shows more columns.
  907.  
  908.      DIRTOT provides National Language Support.  If you have set up
  909.      DOS 3.0 or later for a specific country (by including COUNTRY= in
  910.      your CONFIG.SYS file), the time, date, thousands separator and
  911.      decimal separator will adapt to your country's standards.
  912.  
  913.  
  914.  
  915.  
  916.      DIRTOT                                                    Page 16
  917.  
  918.  
  919.      /---------------------------------------------------------------\
  920.      |                                                               |
  921.      |                     QUESTIONS AND ANSWERS                     |
  922.      |                                                               |
  923.      \---------------------------------------------------------------/
  924.  
  925.      Why do DIRTOT and CHKDSK report different amounts of space used
  926.      on the disk?
  927.  
  928.         CHKDSK counts the unused space at the end of each file - the
  929.         rest of the "Allocation Unit" or "Cluster", and counts hidden
  930.         files separately.  DIRTOT can count the allocated space and/or
  931.         the actual space each file uses, as reported in a directory
  932.         listing.  If you add CHKDSK's amounts for hidden and user
  933.         files it should match DIRTOT's amount for Total Allocated.
  934.  
  935.         Some versions of CHKDSK may report one more file, because they
  936.         count the volume ID as a hidden file.
  937.  
  938.      Why do DIRTOT and DIR report different numbers of files in a
  939.      subdirectory?
  940.  
  941.         DIR counts the '.' and '..' DOS housekeeping files, but
  942.         ignores any Hidden files.  DIRTOT ignores the '.' and '..'
  943.         files, and counts any Hidden files.
  944.  
  945.      Why do some numbers show as 0K and others as just plain 0?
  946.  
  947.         Numbers in Kilobytes and Megabytes, and percents, are rounded
  948.         to the nearest value, but its often important to know whether
  949.         you have a very small number or exactly zero.  0K means the
  950.         actual value is between 1 and 511 inclusive.  .0M means the
  951.         actual value is between 1 and 52,428 inclusive.  <1 (less than
  952.         one) is used in percent displays when the actual value is
  953.         between 0% and 0.5% exclusive.  Just plain 0 means the actual
  954.         value is exactly zero.
  955.  
  956.      Why does DIRTOT take so long to display its results?
  957.  
  958.         In order to come up with its totals DIRTOT must read the
  959.         entire directory structure of your hard disk.  The final grand
  960.         total appears on the very first line, and the width of the
  961.         output is unknown until the deepest subdirectory has been
  962.         scanned.  Quincunx Software has done its best to minimize this
  963.         time.  Since the vast majority of the time is spent in DOS
  964.         waiting for the disk, we believe DIRTOT is as fast as or
  965.         faster than any other utility that reads the entire directory
  966.         structure.
  967.  
  968.      My disk has 19 levels of subdirectories on it.  How are you going
  969.      to handle that?
  970.  
  971.  
  972.  
  973.  
  974.      DIRTOT                                                    Page 17
  975.  
  976.  
  977.         The listing expands in width until it fills the screen, then
  978.         additional levels of subdirectories are shown in a column with
  979.         a level number:
  980.  
  981.            Directory           Total Alloc  Total Used   Files
  982.            ------------------  -----------  -----------  -----
  983.            DIRECTOR.001                  0            0      0
  984.            └─A                           0            0      0
  985.              └─B                         0            0      0
  986.                └─C                       0            0      0
  987.                  └─D                     0            0      0
  988.                    └─E                   0            0      0
  989.                      └─F                 0            0      0
  990.                     7> G                 0            0      0
  991.                     8> H                 0            0      0
  992.                     9> I                 0            0      0
  993.                    10> J                 0            0      0
  994.                    11> K                 0            0      0
  995.                    12> L                 0            0      0
  996.                    13> M                 0            0      0
  997.                    14> N                 0            0      0
  998.                    15> O                 0            0      0
  999.                    16> P                 0            0      0
  1000.                    17> Q                 0            0      0
  1001.                    18> R                 0            0      0
  1002.                    19> S                 0            0      0
  1003.  
  1004.         Exactly when this happens depends on the settings for report
  1005.         format, indent and number format.
  1006.  
  1007.      Just what does the percent column mean?  Shouldn't it add up to
  1008.      100%?
  1009.  
  1010.         There are two types of percent columns.  First, the easy one: 
  1011.         Percent Backup is the Backup column (number of bytes needing
  1012.         backup) divided by the Total Used column IN THAT SAME REPORT
  1013.         LINE.  In the example below the BIN directory has 3,832 bytes
  1014.         needing backup out of 1,996,054 used, equaling 0.19%, shown as
  1015.         "<1", less than one percent.  In the INIT directory all 19,190
  1016.         bytes need backup, 100% of that directory.  But for the
  1017.         overall C600 directory structure, less than one percent need
  1018.         backup.  (The Total Used column need not be reported to get
  1019.         percent Backup, the figures are still available internally.)
  1020.  
  1021.  
  1022.  
  1023.  
  1024.      DIRTOT                                                    Page 18
  1025.  
  1026.  
  1027.            Directory  Total Used   Backup   % 
  1028.            ---------  -----------  ------  ---
  1029.            C600         5,803,188  23,022   <1
  1030.            ├─BIN        1,996,054   3,832   <1
  1031.            ├─BINB         374,879       0    0
  1032.            ├─HELP       2,054,723       0    0
  1033.            ├─INCLUDE      123,448       0    0
  1034.            │ └─SYS          4,327       0    0
  1035.            ├─INIT          19,190  19,190  100
  1036.            └─LIB        1,234,894       0    0
  1037.  
  1038.         The second type of percent applies to Total Allocated, Total
  1039.         Used, or Files.  The percent column indicates PERCENT OF THE
  1040.         PREVIOUS DIRECTORY LEVEL TOTAL.  In the example below the SYS
  1041.         directory uses 4% of the space used by INCLUDE and SYS, and
  1042.         INCLUDE and SYS uses 2% of the space used by the whole C600
  1043.         structure.  The BIN directory contains 34% of the space used
  1044.         by the C600 structure.  The first line of the report will
  1045.         never show anything for these percents, since there is no
  1046.         previous level to reference.
  1047.  
  1048.            Directory  Total Used    % 
  1049.            ---------  -----------  ---
  1050.            C600         5,803,188     
  1051.            ├─BIN        1,996,054   34
  1052.            ├─BINB         374,879    6
  1053.            ├─HELP       2,054,723   35
  1054.            ├─INCLUDE      123,448    2
  1055.            │ └─SYS          4,327    4
  1056.            ├─INIT          19,190   <1
  1057.            └─LIB        1,234,894   21
  1058.  
  1059.         The only occasion when things would add up to 100% is if the
  1060.         previous level contained no files and you added the percents
  1061.         for just one level.  From above that would be
  1062.         BIN+BINB+HELP+INCLUDE+INIT+LIB, but it still won't quite add
  1063.         up because the figures are rounded.
  1064.  
  1065.      I set Indent to 8 but the report is only indenting 2.  What's
  1066.      wrong?
  1067.  
  1068.         Automatic Report Formatting is overriding your setting in
  1069.         order to fit everything across the page.  To produce an indent
  1070.         of 8 you will have to give up one (or more) columns or use a
  1071.         wider display or printer.  The same thing can happen with
  1072.         Number format and Commas.
  1073.  
  1074.  
  1075.  
  1076.  
  1077.      DIRTOT                                                    Page 19
  1078.  
  1079.  
  1080.      /---------------------------------------------------------------\
  1081.      |                                                               |
  1082.      |                      TIPS AND TECHNIQUES                      |
  1083.      |                                                               |
  1084.      \---------------------------------------------------------------/
  1085.  
  1086.      To produce the briefest possible listing of the space used and
  1087.      free on several drives use the Brief, max Level 0, and Megabyte
  1088.      options with a report Format of Name, Total used (or total
  1089.      alloCated if you prefer), and free Space:
  1090.  
  1091.         dirtot /blnmfnts c: d: e:
  1092.  
  1093.         C:\           127.7M   23.2M
  1094.  
  1095.         D:\           114.1M    8.6M
  1096.  
  1097.         E:\            23.4M    1.2M
  1098.  
  1099.      The predefined layout [usedfree] is set up to do this
  1100.      automatically.  You can even preset your list of drives.  Edit
  1101.      the DIRTOT.INI file.  Find the section heading [usedfree], and
  1102.      the Path = "" immediately after it.  Put your drives in the list,
  1103.      for example Path = "c: d: e:".  Then you can just type:
  1104.  
  1105.         dirtot [usedfree]
  1106.  
  1107.      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1108.  
  1109.      To get a good picture of the space used by the various major
  1110.      programs on your system, use the Level 1 option, the Sort by
  1111.      Total used option, and a report format including Percent:
  1112.  
  1113.         dirtot /l1st /fnt% c:\
  1114.  
  1115.         Directory       Total Used    % 
  1116.         --------------  -----------  ---
  1117.         C:\             205,625,443     
  1118.         ├─BC4            43,870,703   21
  1119.         ├─WINDOWS        22,236,026   11
  1120.         ├─ZAPP            9,304,432    5
  1121.         ├─DOS             6,085,019    3
  1122.         ├─C600            5,803,188    3
  1123.         ├─WP51            3,672,475    2
  1124.         ├─UTILITY         2,336,327    1
  1125.            .
  1126.            .
  1127.            .
  1128.         ├─DIRTOT            797,437   <1
  1129.         ├─TEST              107,414   <1
  1130.         └─TEMP                    0    0
  1131.  
  1132.  
  1133.      The predefined layout [big] is set up to do this automatically.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.      DIRTOT                                                    Page 20
  1139.  
  1140.  
  1141.      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1142.  
  1143.      You can cancel DIRTOT at any time by pressing "Esc".  The report
  1144.      will say "*** Cancelled" at the end.
  1145.  
  1146.  
  1147.  
  1148.  
  1149.      DIRTOT                                                    Page 21
  1150.  
  1151.  
  1152.      /---------------------------------------------------------------\
  1153.      |                                                               |
  1154.      |                         ERROR MESSAGES                        |
  1155.      |                                                               |
  1156.      \---------------------------------------------------------------/
  1157.  
  1158.      INITIALIZATION FILE ERRORS:
  1159.  
  1160.      *** INI file DIRTOT.INI line ##: ...
  1161.  
  1162.        ...Section not found
  1163.  
  1164.         This usually occurs when you misspell a predefined layout on
  1165.         the command line.
  1166.  
  1167.        ...File not found
  1168.  
  1169.         DIRTOT could not find its initialization file in either the
  1170.         current directory or the directory where DIRTOT.EXE is
  1171.         located.  This is a warning only.  DIRTOT will run with its
  1172.         default and command line settings.
  1173.  
  1174.         It is also possible that another program has opened the .INI
  1175.         file in a non-shared mode.
  1176.  
  1177.        ...Invalid TRUE/FALSE value
  1178.  
  1179.         The entry on the line indicated must be set to either "TRUE",
  1180.         "ON", a non-zero number, or "FALSE", "OFF", 0.
  1181.  
  1182.        ...Unknown symbol
  1183.  
  1184.         The first word on the line indicated was not found in DIRTOT's
  1185.         table of .INI file entries.  It was either misspelled or a
  1186.         comment indicator (;) is missing.
  1187.  
  1188.        ...Error reading file
  1189.  
  1190.         A disk error occurred while reading the .INI file.
  1191.  
  1192.        ...Invalid type
  1193.        ...Out of memory
  1194.        ...Section too large
  1195.        ...Unknown error code
  1196.  
  1197.         These last four error messages should not occur in this
  1198.         program.  Please report these problems to Quincunx Software.
  1199.  
  1200.  
  1201.  
  1202.  
  1203.      DIRTOT                                                    Page 22
  1204.  
  1205.  
  1206.      SETTINGS ERRORS:
  1207.  
  1208.      *** Unknown option 'x'
  1209.  
  1210.         You entered a command line option which DIRTOT did not
  1211.         recognize, or combined options in a single string in an
  1212.         invalid manner.
  1213.  
  1214.      *** No report format specified
  1215.  
  1216.         The "Format" entry in the .INI file or the command line option
  1217.         'F' were followed by a blank string.
  1218.  
  1219.      *** Invalid format character 'x'
  1220.  
  1221.         The "Format" entry in the .INI file or the command line option
  1222.         'F' contained an invalid character.
  1223.  
  1224.      *** Indent must be 0 to 12
  1225.  
  1226.         The "Indent" entry in the .INI file or the command line option
  1227.         'I' specified an invalid value.
  1228.  
  1229.      *** Maxlevel must be 0 to 31
  1230.  
  1231.         The "MaxLevel" entry in the .INI file or the command line
  1232.         option 'L' specified an invalid value.
  1233.  
  1234.      *** Number format must be 'B', 'K', or 'M'
  1235.  
  1236.         The "NumberFormat" entry in the .INI file or the command line
  1237.         option 'N' specified an invalid value.
  1238.  
  1239.      *** Sort order must be 'N', 'T', 'C', 'L' or 'U'
  1240.  
  1241.         The "Sort" entry in the .INI file or the command line option
  1242.         'S' specified an invalid value.
  1243.  
  1244.      *** Percent must follow 'C', 'T', 'F' or 'B'
  1245.  
  1246.         The percent format specifier in the report format setting can
  1247.         only immediately follow one of the indicated columns.
  1248.  
  1249.  
  1250.      RUN TIME ERRORS:
  1251.  
  1252.      *** Path xxx not found
  1253.  
  1254.         A subdirectory you entered on the command line does not exist. 
  1255.         Maybe you misspelled it, or forgot to put brackets around a
  1256.         predefined layout name.  Try again.
  1257.  
  1258.         If you are running on a network or under a multitasking system
  1259.         there is a slight chance that another program or user removed
  1260.  
  1261.  
  1262.  
  1263.  
  1264.      DIRTOT                                                    Page 23
  1265.  
  1266.  
  1267.         a directory between the time that DIRTOT first detected it and
  1268.         then went back to scan it.
  1269.  
  1270.      *** Invalid drive x:
  1271.  
  1272.         The drive portion of an entry on the command line is not
  1273.         valid.
  1274.  
  1275.      *** Internal storage full, complete path not scanned
  1276.  
  1277.         There is no more conventional memory available to store
  1278.         subdirectories.  DIRTOT will report what it has, but it did
  1279.         not cover your entire disk.
  1280.  
  1281.         DIRTOT has room to store over 10000 subdirectories, so to get
  1282.         this message you either must have a VERY large disk or are
  1283.         running DIRTOT with limited available memory.  If you actually
  1284.         have more than 10000 subdirectories, let Quincunx Software
  1285.         know so we can consider producing an expanded version.
  1286.  
  1287.      *** More than #### subdirs, complete directory not scanned
  1288.  
  1289.         where #### is a number on the order of one thousand.  One
  1290.         directory contained more than that many subdirectories at the
  1291.         next level.  DIRTOT will report the rest of the disk
  1292.         correctly.  Let Quincunx Software know so we can consider
  1293.         producing an expanded version.
  1294.  
  1295.      *** Only 32 levels supported
  1296.  
  1297.         A subdirectory structure exists which contains more than 32
  1298.         levels of directories.  This is not normally possible under
  1299.         DOS.  Please report this problem to Quincunx Software.
  1300.  
  1301.  
  1302.      REGISTRATION FILE ERRORS:
  1303.  
  1304.      In each of the following messages where an error code number (#)
  1305.      is shown, the number is the DOS error code.  Common codes are:
  1306.  
  1307.          2 - File not found
  1308.          5 - Access denied
  1309.  
  1310.      *** Error # opening registration data file DIRTOT.REG
  1311.  
  1312.         Be sure DIRTOT.REG is located in the same directory as
  1313.         DIRTOT.EXE.  This message will usually be followed by "***
  1314.         Invalid registration data in DIRTOT.REG" and "*** UNREGISTERED
  1315.         copy - Registration data invalid".
  1316.  
  1317.  
  1318.  
  1319.  
  1320.      DIRTOT                                                    Page 24
  1321.  
  1322.  
  1323.      *** Error # creating registration data file DIRTOT.REG
  1324.      *** Error # reading registration data file DIRTOT.REG
  1325.      *** Error # writing registration data file DIRTOT.REG
  1326.      *** Error # closing registration data file DIRTOT.REG
  1327.  
  1328.         A disk or network access problem is occurring.
  1329.  
  1330.      *** Invalid registration data in DIRTOT.REG
  1331.      *** UNREGISTERED copy - Registration data invalid
  1332.  
  1333.         The file DIRTOT.REG contains invalid info or is from the wrong
  1334.         version of DIRTOT.  This usually occurs if DIRTOT.REG was
  1335.         deleted or not found and automatically recreated.  Be sure
  1336.         DIRTOT.REG is located in the same directory as DIRTOT.EXE, or
  1337.         reinstall from your original copy.
  1338.  
  1339.      *** Invalid registration data
  1340.  
  1341.         This error occurs if you enter your registration info
  1342.         incorrectly.  Try again and be sure you enter the exact
  1343.         letters and numbers shown on your registration data sheet.  If
  1344.         you cannot resolve the problem contact Quincunx Software.
  1345.  
  1346.  
  1347.  
  1348.  
  1349.      DIRTOT                                                    Page 25
  1350.  
  1351.  
  1352.      /---------------------------------------------------------------\
  1353.      |                                                               |
  1354.      |                            SUPPORT                            |
  1355.      |                                                               |
  1356.      \---------------------------------------------------------------/
  1357.  
  1358.      The policy of Quincunx Software is to provide a reasonable amount
  1359.      of free support to all users, registered or not.  You can reach
  1360.      us by:
  1361.  
  1362.      E-Mail:
  1363.  
  1364.         75240.2051@compuserve.com
  1365.  
  1366.      FAX:
  1367.  
  1368.         1-608-924-5841  (This is a shared voice/fax line.  Ignore the
  1369.         answering machine and start your fax.)
  1370.  
  1371.      BBS:
  1372.  
  1373.         Leave a message to Tom Caswick on the Madison PC User's Group
  1374.         BBS at 1-608-233-0286
  1375.  
  1376.      U.S. Mail:
  1377.  
  1378.         Quincunx Software
  1379.         8178 Aldgwen Rd.
  1380.         Barneveld, WI 53507
  1381.  
  1382.      Voice phone:
  1383.  
  1384.         1-608-924-5841 (10 am to 6 pm Central time, Monday through
  1385.         Friday).  All calls are screened by answering machine.  If you
  1386.         say you are calling about DIRTOT we will probably answer
  1387.         immediately.  If you don't leave a message you will probably
  1388.         never reach us.
  1389.  
  1390.      When writing be sure to specify the version of DIRTOT, give as
  1391.      much detail about the problem as seems reasonable, and give us at
  1392.      least one way that we can reach you.
  1393.  
  1394.  
  1395.  
  1396.  
  1397.      DIRTOT                                                    Page 26
  1398.  
  1399.  
  1400.      /---------------------------------------------------------------\
  1401.      |                                                               |
  1402.      |                          REGISTRATION                         |
  1403.      |                                                               |
  1404.      \---------------------------------------------------------------/
  1405.  
  1406.      DIRTOT is distributed as Shareware.  You are encouraged to give
  1407.      copies to your friends, co-workers, and user groups, and upload
  1408.      copies to Bulletin Board Systems.  We strongly recommend that you
  1409.      distribute the original authenticity verified ZIP file.  All
  1410.      copies must be unaltered and include at least the files
  1411.      DIRTOT.EXE, DIRTOT.INI, DIRTOT.REG, and DIRTOT.DOC.  The author,
  1412.      Quincunx Software, retains all other rights to the program.
  1413.  
  1414.      IF YOU HAVE REGISTERED DIRTOT, DO NOT GIVE AWAY COPIES OF YOUR
  1415.      DIRTOT.REG FILE.  IT CONTAINS YOUR NAME, ADDRESS, AND
  1416.      REGISTRATION NUMBER.  Only distribute the original ZIP file.
  1417.  
  1418.      The latest version of DIRTOT will always be available on
  1419.      Compuserve, in the PC Utilities/Systems forum, DOS Utilities
  1420.      section, and on the Madison PC User's Group BBS at 1-608-233-
  1421.      0286.
  1422.  
  1423.      Non-registered users of this software are granted a limited
  1424.      license to make an evaluation copy for trial use on a private,
  1425.      non-commercial basis, for the express purpose of determining
  1426.      whether DIRTOT is suitable for their needs.  At the end of this
  1427.      trial period, you must either register your copy or discontinue
  1428.      using DIRTOT.
  1429.  
  1430.      Should you decide to use DIRTOT, or keep it on your hard disk for
  1431.      future use, you are obligated to pay a registration fee of $10.00
  1432.      (Ten U.S. Dollars).  Send payment in check or money order to:
  1433.  
  1434.                              Quincunx Software
  1435.                               8178 Aldgwen Rd.
  1436.                             Barneveld, WI 53507
  1437.  
  1438.      You will receive your personalized registration data by return
  1439.      mail.
  1440.  
  1441.      In order to encourage users to register, DIRTOT incorporates a
  1442.      Registration Reminder system.  The end of each report lists how
  1443.      long this copy has been in use and how many times it has been
  1444.      run:
  1445.  
  1446.              UNREGISTERED copy - Run 2 times - In use 1 day
  1447.  
  1448.      After 30 days a longer reminder will begin appearing randomly. 
  1449.      The longer you have used DIRTOT without registering it, the more
  1450.      frequent these reminders will become.
  1451.  
  1452.      To eliminate these annoying reminder messages, to help produce
  1453.      more and better versions of DIRTOT, and to satisfy your
  1454.  
  1455.  
  1456.  
  1457.  
  1458.      DIRTOT                                                    Page 27
  1459.  
  1460.  
  1461.      conscience by paying for what you are using, please send in your
  1462.      registration fee.
  1463.  
  1464.      When you receive your registration information you need to enter
  1465.      it into DIRTOT as shown in the following example:
  1466.  
  1467.         dirtot /r
  1468.         Enter Registered Name     : Tom Caswick
  1469.         Enter Registered Location : Barneveld, WI
  1470.         Enter Registration Number : 12345
  1471.         Registration data updated.
  1472.  
  1473.      Run DIRTOT with the /r command line option.  It will request the
  1474.      name, location, and number that were supplied to you.  You must
  1475.      enter these exactly as provided, except that spacing, upper/lower
  1476.      case, and punctuation do not matter.  If everything is correct
  1477.      your registration will be accepted.  The end of all future
  1478.      reports will list:
  1479.  
  1480.      Registered to             Tom Caswick              Barneveld, WI
  1481.  
  1482.      instead of the Registration Reminder.  Your registration data is
  1483.      stored in the file DIRTOT.REG.  Do not give copies of this file
  1484.      to anyone, or your name and address will begin to appear on
  1485.      DIRTOT reports around the world.  Distributing your registration
  1486.      data is equivalent to software piracy, and Quincunx Software will
  1487.      take legal action against you.
  1488.  
  1489.      Whether you register or not, please notify Quincunx Software of
  1490.      any problems you encounter using DIRTOT, and of any improvements
  1491.      you would like to see.
  1492.  
  1493.      Quantity discounts and site licenses are available.  Call or
  1494.      write for information.
  1495.  
  1496.      Companies and organizations that provide software duplication
  1497.      services may include DIRTOT in their catalog and provide copies
  1498.      for a reasonable duplication fee, provided the purchaser is
  1499.      notified that no portion of the fee goes to the Shareware author
  1500.      and that the purchaser is still obligated to register.
  1501.  
  1502.      Quincunx Software hereby disclaims all warranties relating to
  1503.      this software, whether express or implied, including without
  1504.      limitation any implied warranties of merchantability or fitness
  1505.      for a particular purpose.  Quincunx Software will not be liable
  1506.      for any special, incidental, consequential, indirect or similar
  1507.      damages due to loss of data or any other reason, even if Quincunx
  1508.      Software or an agent of Quincunx Software has been advised of the
  1509.      possibility of such damages.  In no event shall Quincunx
  1510.      Software's liability for any damages ever exceed the price paid
  1511.      for the license to use this software, regardless of the form of
  1512.      the claim.
  1513.  
  1514.  
  1515.  
  1516.  
  1517.      DIRTOT                                                    Page 28
  1518.  
  1519.  
  1520.      /---------------------------------------------------------------\
  1521.      |                                                               |
  1522.      |                    ABOUT QUINCUNX SOFTWARE                    |
  1523.      |                                                               |
  1524.      \---------------------------------------------------------------/
  1525.  
  1526.      Quincunx Software was founded in 1983.  We have provided
  1527.      consulting and contract programming services to numerous large
  1528.      and small companies, including IBM, Citicorp, and Sears.  We have
  1529.      special expertise in C programming, communication, and the
  1530.      S.W.I.F.T. international electronic funds transfer network.
  1531.  
  1532.      Tom Caswick, owner and president of Quincunx Software, has over
  1533.      20 years of experience programming a wide range of computers,
  1534.      from mainframes to microcontrollers.
  1535.  
  1536.      DIRTOT is Quincunx Software's first Shareware product.  It was
  1537.      originally released in April 1992.
  1538.  
  1539.  
  1540.  
  1541.  
  1542.      DIRTOT                                                    Page 29
  1543.  
  1544.  
  1545.      /---------------------------------------------------------------\
  1546.      |                                                               |
  1547.      |                             INDEX                             |
  1548.      |                                                               |
  1549.      \---------------------------------------------------------------/
  1550.  
  1551.           .0M . . . . . . . . . . . . . . . . . . . . . . . .  16
  1552.           '..'  . . . . . . . . . . . . . . . . . . . . . . .  16
  1553.           '.' . . . . . . . . . . . . . . . . . . . . . . . .  16
  1554.           <1  . . . . . . . . . . . . . . . . . . . . . 10, 16-19
  1555.           0K  . . . . . . . . . . . . . . . . . . . . . . . .  16
  1556.           Allocation Unit . . . . . . . . . . . . . . . . . .  16
  1557.           Archive . . . . . . . . . . . . . . . . . . . . . . . 9
  1558.           ASCII . . . . . . . . . . . . . . . . . . . . . . 8, 15
  1559.           Attributes  . . . . . . . . . . . . . . . . . . . 9, 15
  1560.           Automatic report formatting . . .  2, 8, 11, 12, 15, 18
  1561.           Backup  . . . . . . . . . . . . . . . . . . . . . . . 9
  1562.           BBS . . . . . . . . . . . . . . . . . . . . . .  25, 26
  1563.           Beep  . . . . . . . . . . . . . . . . . . . . . . .  12
  1564.           Brief . . . . . . . . . . . . . . . . . . . . . . 8, 19
  1565.           Cancel  . . . . . . . . . . . . . . . . . . . . . 2, 20
  1566.           Child directories . . . . . . . . . . . . . . . . . . 9
  1567.           CHKDSK  . . . . . . . . . . . . . . . . . . . . . .  16
  1568.           Cluster . . . . . . . . . . . . . . . . . . .  2, 9, 16
  1569.           Columns . . . . . . . . . . . . . . . . . 2, 11, 13, 15
  1570.           Command line  . . . . . . 2, 4, 5, 7, 8, 11, 14, 21, 22
  1571.           Commas  . . . . . . . . . . . . . . . . . . . 8, 14, 15
  1572.           Compuserve  . . . . . . . . . . . . . . . . . . . .  26
  1573.           CONFIG.SYS  . . . . . . . . . . . . . . . . . . . .  15
  1574.           Default . . . . . . . . . . . . . . . . . . .  2, 5, 21
  1575.           DIR . . . . . . . . . . . . . . . . . . . . . . . .  16
  1576.           Disclaimer  . . . . . . . . . . . . . . . . . . . .  27
  1577.           DOS . . . . . . . . . . . . . . . . . . 3-5, 15, 16, 23
  1578.           Error messages  . . . . . . . . . . . . . . . 12, 21-23
  1579.           Esc . . . . . . . . . . . . . . . . . . . . . . . 2, 20
  1580.           Hard disk . . . . . . . . . . . . . . . .  1, 3, 16, 26
  1581.           Heading . . . . . . . . . . . . . . . . . . .  2, 8, 11
  1582.           Hidden  . . . . . . . . . . . . . . . . . . . .  15, 16
  1583.           Import  . . . . . . . . . . . . . . . . . . . . . .  11
  1584.           Indent  . . . . . . . . . . . . . .  11, 15, 17, 18, 22
  1585.           Initialization file . . . . . 2, 3, 5, 7, 8, 14, 21, 26
  1586.           Latest date . . . . . . . . . . . . . . . . .  2, 9, 12
  1587.           Levels  . . . . . . . . . . . . . .  2, 4, 5, 9, 11, 12
  1588.           License . . . . . . . . . . . . . . . . . . . .  26, 27
  1589.           Lines . . . . . . . . . . . . . . . . . . . . .  14, 15
  1590.           Memory  . . . . . . . . . . . . . . . . . . . 3, 21, 23
  1591.           National Language Support . . . . . . . . . . . . .  15
  1592.           Number format . . . . . . . . . . . .  8, 12, 15-17, 22
  1593.           Number of files . . . . . . . . . . . . . . .  2, 9, 16
  1594.           Options . . . . . . . . . .  4, 5, 7, 8, 11, 14, 15, 22
  1595.           Path  . . . . . . . . . . . . . . . .  2, 3, 14, 22, 23
  1596.           Pause . . . . . . . . . . . . . . . . . . . . 4, 12, 15
  1597.           Percent . . . . . . . . . . . . . . . . .  9, 16-18, 22
  1598.           Printing  . . . . . . . . . . . . . . .  2, 4, 8, 12-15
  1599.  
  1600.  
  1601.  
  1602.  
  1603.      DIRTOT                                                    Page 30
  1604.  
  1605.  
  1606.           Question mark . . . . . . . . . . . . . . . . . . .  15
  1607.           Quiet . . . . . . . . . . . . . . . . . . . . . . .  12
  1608.           Quincunx Software . . . . . . . . . . . . . .  1, 25-28
  1609.           Redirection . . . . . . . . . . . . . . . . . . . 4, 12
  1610.           Registration  . . . . . . . . . . . .  3, 12, 23, 25-27
  1611.           Report format . . . . . . . . . . . 1, 2, 9, 17, 19, 22
  1612.           Rows  . . . . . . . . . . . . . . . . . . . . .  14, 15
  1613.           Screen width  . . . . . . . . . . . . . . .  14, 15, 17
  1614.           Semicolon . . . . . . . . . . . . . . . . . . . . 5, 14
  1615.           Shareware . . . . . . . . . . . . . . . . . . . . .  26
  1616.           Sort  . . . . . . . . . . . . . . . . . . 2, 12, 19, 22
  1617.           Space allocated . . . . . . . . . . .  2, 9, 12, 16, 19
  1618.           Space free  . . . . . . . . . . . . . . . . . . 1, 2, 9
  1619.           Space used  . . . . . . . . . . . . 1, 2, 9, 12, 16, 19
  1620.           Support . . . . . . . . . . . . . . . . . . . . . .  25
  1621.           System  . . . . . . . . . . . . . . . . . 2, 15, 19, 22
  1622.           Thousands separator . . . . . . . . . . . . . . . 8, 15
  1623.           Tree branches . . . . . . . . . . . . . 2, 8, 9, 11, 13
  1624.           Unprintable characters  . . . . . . . . . . . . . 2, 15
  1625.           Volume ID . . . . . . . . . . . . . . . . . . 2, 15, 16
  1626.  
  1627.  
  1628.  
  1629.  
  1630.                           DIRTOT REGISTRATION FORM
  1631.  
  1632.                              Quincunx Software
  1633.                               8178 Aldgwen Rd.
  1634.                             Barneveld, WI 53507
  1635.                            Phone/FAX 608-924-5841
  1636.                      E-Mail: 75240.2051@compuserve.com
  1637.  
  1638.  
  1639.      Name: _______________________________________________________
  1640.  
  1641.      Company:  _______________________________________________________
  1642.  
  1643.      Address:  _______________________________________________________
  1644.  
  1645.            _______________________________________________________
  1646.  
  1647.      City: ________________________  State: _____  Zip: __________
  1648.  
  1649.      Country:  _______________________________________________________
  1650.  
  1651.      Phone:    _______________________________________________________
  1652.  
  1653.  
  1654.      Please register DIRTOT Version 1.6 in the above name.
  1655.  
  1656.      _______ copies at $10.00 per copy.  Amount enclosed _____________
  1657.  
  1658.  
  1659.      Suggested enhancements:
  1660.  
  1661.      _________________________________________________________________
  1662.  
  1663.      _________________________________________________________________
  1664.  
  1665.      _________________________________________________________________
  1666.  
  1667.      _________________________________________________________________
  1668.  
  1669.      _________________________________________________________________
  1670.  
  1671.      _________________________________________________________________
  1672.  
  1673.      _________________________________________________________________
  1674.  
  1675.      _________________________________________________________________
  1676.