--------------------------------------------------------------------------------
 GENERAL INFORMATION
 SumDisk is a utility that audits the space usage on any disk, highlighting
 directories and files that are consuming the bulk of your disk real estate.
 It will help you quickly target items to purge when space gets tight.

 SumDisk has several options to customize your disk audit (see topics on
 Command Line Options and Function/Control Key Usage).  Important ones are:

 ──────────────────────────────────────────────────────────────────────────
                OPTION                           HELP FILE TOPIC
 ──────────────────────────────────────────────────────────────────────────
        Marking file duplicates               Quick/Exact Duplicates
        Restricting the Files list            Command Line Options
        Search functions                      Searching
        Deleting files                        Deleting Files
        Viewing files                         Viewing Files
        Outputting audit results              Outputting Results
 ──────────────────────────────────────────────────────────────────────────

 You can view sorted lists of the disk's directories; primary directories 
 with their subdirectories' accumulated totals; and (optionally) up to
 3,000 of the largest files.  SumDisk can show each list sorted either by
 size or by name.
--------------------------------------------------------------------------------
 DISPLAY INFORMATION
 The default audit screen displays a list of three pieces of information:
 on the left, a bar that shows the relative size of a directory instance;
 in the middle, the full pathname of that instance; and on the right, the 
 kilobytes of space DOS has assigned to it (see the topic Clusters,
 Sectors, and Bytes).  Directories are sorted by size, in kilobytes.
 SumDisk abbreviates names to a maximum of 39 characters.

 You can deviate from the default screen by choosing to:

    » Sort the list by name instead of size (F2).
    » Display the Primary Directory list, which includes all directories in
      root totalled with their subdirectories (Ctrl-F1).
    » Display the Files list (Alt-F1).
    » Display full pathnames and erase the size gauge (F5).
    » Express the disk space used in either bytes or percent of disk (F3).

 The size gauge always keys on the largest disk unit being displayed, whether
 directory, primary directory, or file.  It is 25 characters wide for the
 largest unit and proportionally smaller on all others.
--------------------------------------------------------------------------------
 FUNCTION/CONTROL KEY USAGE
 F1        Call upon Help Screens.
 Shift-F1  Select the Directories List.
 Ctrl-F1   Select the Primary Directories List.
 Alt-F1    Select the Files List.
 F2        Toggle the list's sorting between By Size and By Name.
 F3        Toggle the disk space units between Kb Space, Bytes, and Disk %.
 F4        Toggle the list's spacing between Double and Single spacing.
 F5        Toggle the display between the Size Gauge with abbreviated names
           and no Size Gauge but full names.
 F6        Display Miscellaneous Information about this drive.
 F7        Search for a Name (sub)string.
 Shift-F7  Search for the next file Duplicate.
 Ctrl-F7   Search for the next file marked to Delete.
 Alt-F7    Repeat the latest Search.
 F8        Do a Quick Duplicate check.
 Shift-F8  Do an Exact Duplicate check.
 F9        Toggle the Color Scheme.
 F10       Initiate Output of audit results to file(s).

 Ctrl-D    Select a file to mark/unmark for deletion.
 Ctrl-V    Select a file to view.
 Ctrl-X    Exclude the largest file from the Files list.
--------------------------------------------------------------------------------
 COMMAND LINE OPTIONS
 With one exception, command line switches must begin with a '/' or a '-' 
 token.  SumDisk interprets only the first character in the switch and
 ignores case.  For example, '/D' produces the same results as '-dir'.  Any
 switch without a token is accepted as the requested drive(s) to audit.

 C:            Audit drive C:.  (version 2.11 can audit 2 drives at once)
 /Color=n      On color monitors, use color scheme 'n'. ('n' can be 0 to 5)
 /Dir          Produce lists for only directories and primary directories.
 /Exclude=...  Compile a Files list, excluding files matching the comma-
               separated wildcards (up to 5).
 /Files=n      Compile a Files list with a maximum of 'n' entries.
 /Include=...  Compile a Files list, including only files matching the 
               comma-separated wildcards (up to 5).
 /SkipLow      Skip low-level disk access.  Useful for auditing non-standard
               drives, and for maximizing the number of files listed.
 /Xclude=...   Compile a Files list, excluding files matching the wildcards.

 Example:  sumdisk c:,d: /c=3 /f=100 /x=*.exe,*.zip

 Meaning:  Do an audit on drives C: and D:.  Display it in color scheme 3.
           Develop a list of up to the 100 largest files which are neither
           .EXE nor .ZIP files.
-------------------------------------------------------------------------------
 SEARCHING
 Name Search (F7) will prompt you for a text string.  SumDisk will find
 the next occurrence of that string within the names in the presently
 displayed list.

 Duplicate Search (Shift-F7) will locate and display the next marked
 duplicate in the Files list.

 Delete Search (Ctrl-F7) will locate and display the next file marked
 for deletion.

 Repeat Search (Alt-F7) will repeat the most recent search.  SumDisk
 remembers whether it was a Name Search, Duplicate Search, or Delete Search.
--------------------------------------------------------------------------------
 QUICK/EXACT DUPLICATES
 SumDisk identifies file duplicate sets by marking the file entry with a
 lowercase character.  File neighbors with the same character are probable
 or definite duplicates, depending upon whether Quick Duplicates or Exact
 Duplicates was used.

 Quick Duplicates (F8) almost instantly marks probable duplicate file sets.
 It marks files with the same size, time stamp, and date stamp.  This is
 usually, but not always, accurate.  NOTE:  commercial software packages
 often include support files that have subtle differences but pass Quick
 Duplicates' tests (for example, device drivers).

 Exact Duplicates (Shift-F8) does a byte-by-byte file comparison of all
 files of the same size.  It will accurately mark duplicate file sets.
 However, the process may take up to several minutes, depending upon how
 many entries must be compared.

 In a long Files list, use Duplicate Search (Shift-F7) to review your
 duplicate file sets.
--------------------------------------------------------------------------------
 OUTPUTTING RESULTS
 SumDisk maintains separate lists for directories, primary directories, and
 files.  Each list can be sorted by either name or size.  The Output option
 lets you store the drive's audit results in new files, one for each of the
 lists.  The files may include the by-size sort, the by-name sort, or both.
 The approximate size of the complete output file (with both by-size and
 by-name sorts) is given at the bottom of the box.

 The default names for these three files are SUMDISK.DIR, SUMDISK.PRI, and
 SUMDISK.FIL, but you can change them to any valid DOS file name. If you
 don't wish one of the lists, simply blank out its file name in the prompt
 box by pressing <Esc> and then <Enter>.

 If you want to print any of the lists, type in the printer device name.
 For most users, this is "PRN" or "LPT1".  If your printer is attached to
 a serial port, the device name is probably "COM1".


 NOTE:  A complete Files list can be more than a quarter megabyte!  You can
 limit the size by using the /Files switch on the command line, by 
 requesting an output list of only the by-size sort or the by-name sort, or
 by requesting only the duplicate file sets.
--------------------------------------------------------------------------------
 DELETING FILES
 You can use either the mouse or the menus to delete files.  Using the
 mouse is easier!

 While viewing a Files list, you may mark a file for deletion simply by
 clicking on its name with the RIGHT mouse button.  SumDisk highlights the
 item and places a 'D' at the left edge.  Clicking a second time removes
 the delete mark.

 If you don't have a mouse, call upon the 'Mark/Unmark to Delete' option
 in the Options menu.  Then simply move the highlight bar to the file you
 wish to mark/unmark, using the arrow keys, and press <Enter>. The keyboard
 shortcut for the menu item is Ctrl-D.

 After you have marked several files for deletion, you can review them by
 using Delete Search (Ctrl-F7).

 When you're ready to delete the files you've picked, select
 'Delete Marked Files' from the Options menu.  SumDisk will ask you to
 confirm that you wish to delete all marked files.
--------------------------------------------------------------------------------
 VIEWING FILES
 You can use either the mouse or the menus to view a file.  Using the
 mouse is easier!

 If you have a mouse, simply click on the name of any file in the Files
 list with the LEFT mouse button.  SumDisk will display the file, a
 screenful at a time, in text mode.

 If you don't have a mouse, call upon the 'Pick File to View' option in the
 Options menu, move the highlight bar to the file you wish to see, and
 press <Enter>.  You can use Ctrl-V as a keyboard shortcut.
--------------------------------------------------------------------------------
 CLUSTERS, SECTORS, AND BYTES
 Every file on your disk consists of a set of characters, or 'bytes'.  They
 may be common symbols, such as the alphabet, numerals, and punctuation, or
 they may be unfamiliar, specialized characters.  Each letter, numeral, or
 other symbol is stored as a single byte.

 DOS, the Disk Operating System, packages your files in chunks it can readily
 access.  These 'sectors' normally contain 512 bytes.  If your file has 513
 bytes, DOS stores it in two sectors.  You lose the use of the remaining 511
 bytes in that second sector.  These lost bytes are 'slack' file space.

 On many disks, there may be so many sectors that DOS would have difficulty
 keeping track of every one.  To simplify bookkeeping on your directories and
 files, DOS groups two or more sectors into 'clusters'.  That 513-byte file
 is stored in one cluster, and the space required depends on how large the
 disk's cluster is.  Display Miscellaneous Information (F6) to see the
 present cluster size.  SumDisk converts counts of clusters of any size into
 kilobytes of space, a more familiar measure (two 512-byte sectors).

 SumDisk records disk space usage in both kilobytes and bytes.  Since space
 used is most accurately measured in kilobytes, all lists are sorted that
 way.  Directories may APPEAR to be sorted wrong with space usage shown in
 bytes.  Press F3 to show kilobytes to confirm that they are sorted properly.
--------------------------------------------------------------------------------
 SCROLLING THROUGH THE LIST
 With the keyboard:

    Home              Top of the list
    End               End of the list
    Page Up           Up one screen
    Page Down         Down one screen
    Up/Down arrows    Up/down one item

 With the mouse:

    Click and drag the slider to reposition within the list.

    Click above/below the slider to move up/down one screen.

    Click on the up/down arrow to rapidly scroll through the list.
--------------------------------------------------------------------------------
 SET DEFAULT CONFIGURATION
 SumDisk's audit and presentation format can be customized through command-
 line switches and function key/menu selections.  You can, for example,
 choose to view any of the three disk element lists; use any of six color
 schemes; display in single or double spacing; etc.

 If your preferences for initial settings are different than SumDisk's
 defaults, you can define your own.  SumDisk will create a configuration
 file and use it when doing later audits.  Using the Change Default
 Configuration choice in the Options menu, you can set the following items
 when defining your own configuration values:

        Color scheme
        Unit of measuring disk space   (bytes, kilobytes of space, percent)
        Disk element list   (directories, primaries, files)
        Line spacing   (single, double)
        Option to skip low-level disk access
        Maximum Files list entries

 NOTE:  After you have created your configuration file, you can still
 override all of these items with command-line switches.  The first four
 can also be adjusted while you are reviewing an audit.
--------------------------------------------------------------------------------

