    -------------------------------------------------------------------------
    INTRODUCTION
    -------------------------------------------------------------------------

    The AmigaDOS 'LIST' command provided by the system software is
    versitile by allowing the file's size, blocks, etc. to be displayed.
    However, there is no direct way for the 'LIST' command to report a
    summarized total for all files/ directories listed.  This would
    be useful to quickly determine how much disk storage is being used
    by certain file(s) or directory(s) at the click of the mouse.


    -------------------------------------------------------------------------
    FEATURES
    -------------------------------------------------------------------------

    --------------------------
    Standard features include:
    --------------------------
    o - Multitasks.
    o - Uses standard INTUITION interfaces.
    o - Adjusts to different WORKBENCH environments.


    -------------------------
    Special features include:
    -------------------------
    o - Uses the 'SOFTCONFIG' environment.


    -------------------------
    Program features include:
    -------------------------
    o - Lists total number of file(s) & directory(s) summarized.
    o - Summarizes total bytes used by any file(s)/ pattern(s).
    o - Can easily be started from WORKBENCH using icons/ tooltypes.


    -------------------------------------------------------------------------
    USING SUM
    -------------------------------------------------------------------------

    ----------------
    Getting Started:
    ----------------
    'Sum' can be started from WORKBENCH using the supplied icon, or from
    the CLI/ Shell using:

    >Sum <pale>|<pattern>

    ... if you use the supplied icons(s), be sure to change the name of
    the icon to the device name you would like to summarize (without the
    colon!), or change the 'OPTIONS=' tooltype to specify which device(s)
    or files you would like to summarize.

    (Please refer to the online help file for more information.)


    --------
    Options:
    --------
    The following options are available from the CLI/ Shell.

    ALL ..... This option be placed last (after all devices and paths).
              (Will also summarize file(s)/ pattern(s) located within
               any subdirectories.)

    (For information on 'TOOLTYPES' please refer to the online help file.)


    -----------------
    Files & Patterns:
    -----------------
    'Sum' uses the AmigaDOS 'List' command.  Any file or pattern
    specification allowed by 'List' will work properly with 'Sum'.
    For example:

    >Sum MODS:#?mod#?
    >Sum MODS:#?med#?
    >Sum GAMES: ALL
    >Sum WORK: ALL
    >Sum ENV: ALL
    >Sum GAMES:#? WORK:temp/#? ENV:#?.cfg ALL

    ... etc.,.


    ---------
    Requires:
    ---------
    'Sum' requires the AmigaDOS 'LIST' command to work properly.


    -----------------------
    Software Configuration:
    -----------------------
    The following variables (flags) are used:

    (none)


    -------------------------------------------------------------------------
    FOR ADVANCED USERS
    -------------------------------------------------------------------------

    ------------
    Using Icons:
    ------------
    By setting up a seperate icon for each device, or using the tooltypes
    to specify file(s)/ and or pattern(s), you can quickly display the
    amount of disk space used by certain files, such as certain file
    groups (patterns) on a BBS's subdirectory.


    -------------------------------------------------------------------------
    CREDITS
    -------------------------------------------------------------------------

    This program was designed and coded by Michael Thomas Hurt  of
    MIKE HURT SOFTWARE!, coded in & compiled using Blitz Basic 2.0
    available from Acid Software.

    Software testing was done using:

      o - Amiga 500 : AmigaDOS 2.1, GVP HD 500+ w/ 2MEGS.

      o - Amiga 2000: AmigaDOS 2.1, Microbotics VXL030 w/MMU,
          Microbotics VXLRAM 2MEGS, Microbotics 8-UP! 4MEGS,
          GVP Series II hard card w/ 100MEG HD.

      o - Amiga 3000: AmigaDOS 2.1, 6MEGS.

      o - Amiga 4000: AmigaDOS 3.0


    -------------------------------------------------------------------------
    PROGRAM HISTORY
    -------------------------------------------------------------------------

    v1.0    06/26/1995    Original program.
    v1.1    06/27/1995    Reformatted summarized output.  Corrected file
                          and directory counts.
    v2.0    07/18/1995    Reformatted summarized output.  Added
                          WORKBENCH/ icon startup.