FILESIZE
                           Version 1.5

                 Copyright 1986 by Rob Friefeld
                         March 27, 1991


This utility shows file sizes in records, pages, and kilobytes.  
It accepts an ambiguous file specification and is useful for 
patching and saving, satisfying your curiosity, or watching your 
COM file grow as you add enhancements.  For both ZCPR3 and 
vanilla CP/M.  (The Type-4 version requires ZCPR 3.4 or higher.)

USAGE:

     FILESIZE {dir:}{{afn}.aft} {{/}options}

If no DIR or DU specification is given, the default is the 
current drive and user.  Under vanilla CP/M only a drive should 
be given; the current user will always be used.  If no filename 
is given, the default is all files.  If only a filetype is given, 
the default is all files with that type.  If no options are 
given, the configured defaults are used.

OPTIONS:  A leading slash is only necessary if no directory or 
filename is given.  The options toggle the configured defaults.  
The description below assumes the defaults as distributed.

     P    Turn screen paging off.  Normally FILESIZE will pause 
          when the screen fills and wait for a key press.  The P 
          option will give continuous scrolling, which can be 
          paused with ^S.  Under ZCPR3 the number of screen lines 
          will be obtained from the environment descriptor.  
          Under vanilla CP/M the number of screens lines must be 
          configured.

     S    Include system files.  By default, system (hidden) 
          files will not be found.  You can include them by 
          giving the S option.

Memory requirements vary with the number of matching files found 
by FILESIZE.  If 1,024 files are found, about 15K of memory is 
used, so memory should never be a problem.  Nevertheless, for 
those with limited memory (in their machine, that is) the number 
of files allowed is a configurable option.

Both options can be configured as the defaults.  In addition, the 
number of lines on your screen should be configured for systems 
not running ZCPR3.  Configuration is accomplished using ZCNFG and 
the accompanying FILESZnn.CFG.  For most users configuration 
changes will not be necessary.  The name of the configuration 
file should be left as it is so that ZCNFG will always be able to 
find it even if FILESIZE is renamed.

HISTORY:

Version 1.5a  March 26, 1991  Gene Pizzetta
     Corrected usage screen: effect of options was reversed.  
     Slight revision of CFG file.

Version 1.5 -- March 24, 1991 -- Rob Friefeld
     Type 4 version available.  Much faster on files < 1 extent 
     in size.  File limit installable, but 1024 is recommended.  
     Change this if the program crashes.  Default option report 
     was reversed.

Version 1.4 -- March 20, 1991 -- Gene Pizzetta
     Now handles up to 1024 files (more if re-assembled) and 
     actually checks to see if the file limit has been exceeded.  
     If so, it aborts with a message.  High bits of filenames are 
     filtered for proper display on all terminals.  Can be 
     aborted at any time with ^C, not just at a page pause.  
     Defaults to current directory if none is given.  Automatic 
     wildcarding if no filename is given, and if only filetype is 
     given.  Eliminated extra new line at end of display.  Now 
     wipes out "more" message when continuing after pause.  Under 
     ZCPR3 gets number of screen lines from environment.  Option 
     P toggles screen paging on or off.  Option S toggles 
     inclusion or exclusion of system files.  Options can be 
     configured as defaults using ZCNFG.  Intelligent usage 
     screen shows current effect of options.  Corrected bug that 
     always chose user 0 under CP/M.  Code re-organized for 
     easier modification and maintenance.

Version 1.3 -- Rob Friefeld
     Issued with ZCPR33-only type-3 version.  No changes.

Version 1.2 -- July 1986 -- Rob Friefeld
     Previous version wouldn't handle files with more than 999 
     records.  This version is OK to BDOS limit of 8 meg.  0 
     length files and non-existent files are now differentiated.  
     Pauses when output fills 24 line screen.

Version 1.1 -- Rob Friefeld
     Accepts ambiguous file spec, up to 255 matches.