;
                                 FILESZ.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
FILESZ.4OM     2k (12)   6EAA  1.5        Gene Pizzetta 3/91       Z3COM7
FILESZ.COM     1k (8)    B621  1.5        Gene Pizzetta 3/91       Z3COM7

  1- Syntax/Options  2- Notes                                                 


   FILESZ 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.  (Type-4 version requires ZCPR 3.4 or higher.)
:1
   Syntax   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 - 1/2   

   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.
 Options - 2/2  

   Memory requirements vary with the number of matching files found  by  FILE-
SIZE.  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.
:2
 FILESZ Notes - 1/2 

   a. Version 1.5a updates (3/26/91, Gene Pizzetta):
      - Corrected usage screen: effect of options was reversed.
      - Slight revision of CFG file.

   b. Version 1.5 updates (3/24/91, 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.

   c. Version 1.4 updates (3/20/91, 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.  
 FILESZ Notes - 2/3 

      - 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.

   d. Version 1.3 updates (Rob Friefeld):
      - Issued with ZCPR33-only type-3 version.  No changes.

   e. Version 1.2 updates (7/86, 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.
 FILESZ Notes - 3/3 
 
   f. Version 1.1 updates (Rob Friefeld):
      - Accepts ambiguous file spec, up to 255 matches.
