home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / filesz14.lbr / FILESZ14.DZC / FILESZ14.DOC
Encoding:
Text File  |  1991-03-20  |  3.9 KB  |  87 lines
  1.  
  2.                             FILESIZE
  3.                            Version 1.4
  4.  
  5.                  Copyright 1986 by Rob Friefeld
  6.                   This version by Gene Pizzetta
  7.                          March 20, 1991
  8.  
  9.  
  10. This utility shows file sizes in records, pages, and kilobytes.  
  11. It accepts an ambiguous file specification and is useful for 
  12. patching and saving, satisfying your curiosity, or watching your 
  13. COM file grow as you add enhancements.  For both ZCPR3 and 
  14. vanilla CP/M.
  15.  
  16. USAGE:
  17.  
  18.      FILESIZE {dir:}{{afn}.aft} {{/}options}
  19.  
  20. If no DIR or DU specification is given, the default is the 
  21. current drive and user.  Under vanilla CP/M only a drive should 
  22. be given; the current user will always be used.  If no filename 
  23. is given, the default is all files.  If only a filetype is given, 
  24. the default is all files with that type.  If no options are 
  25. given, the configured defaults are used.
  26.  
  27. OPTIONS:  A leading slash is only necessary if no directory or 
  28. filename is given.  The options toggle the configured defaults.  
  29. The description below assumes the defaults as distributed.
  30.  
  31.      P    Turn screen paging off.  Normally FILESIZE will pause 
  32.           when the screen fills and wait for a key press.  The P 
  33.           option will give continuous scrolling, which can be 
  34.           paused with ^S.  Under ZCPR3 the number of screen lines 
  35.           will be obtained from the environment descriptor.  
  36.           Under vanilla CP/M the number of screens lines must be 
  37.           configured.
  38.  
  39.      S    Include system files.  By default, system (hidden) 
  40.           files will not be found.  You can include them by 
  41.           giving the S option.
  42.  
  43. Memory requirements vary with the number of matching files found 
  44. by FILESIZE.  If 1,024 files are found, about 12K of memory is 
  45. used, so memory should never be a problem.  Nevertheless, be 
  46. warned that no memory check is made.
  47.  
  48. Both options can be configured as the defaults.  In addition, the 
  49. number of lines on your screen should be configured for systems 
  50. not running ZCPR3.  Configuration is accomplished using ZCNFG and 
  51. the accompanying FILESZnn.CFG.  For most users configuration 
  52. changes will not be necessary.  The name of the configuration 
  53. file should be left as it is so that ZCNFG will always be able to 
  54. find it even if FILESIZE is renamed.
  55.  
  56. HISTORY:
  57.  
  58. Version 1.4 -- March 20, 1991 -- Gene Pizzetta
  59.      Now handles up to 1024 files (more if re-assembled) and 
  60.      actually checks to see if the file limit has been exceeded.  
  61.      If so, it aborts with a message.  High bits of filenames are 
  62.      filtered for proper display on all terminals.  Can be 
  63.      aborted at any time with ^C, not just at a page pause.  
  64.      Defaults to current directory if none is given.  Automatic 
  65.      wildcarding if no filename is given, and if only filetype is 
  66.      given.  Eliminated extra new line at end of display.  Now 
  67.      wipes out "more" message when continuing after pause.  Under 
  68.      ZCPR3 gets number of screen lines from environment.  Option 
  69.      P toggles screen paging on or off.  Option S toggles 
  70.      inclusion or exclusion of system files.  Options can be 
  71.      configured as defaults using ZCNFG.  Intelligent usage 
  72.      screen shows current effect of options.  Corrected bug that 
  73.      always chose user 0 under CP/M.  Code re-organized for 
  74.      easier modification and maintenance.
  75.  
  76. Version 1.3 -- Rob Friefeld, Long Beach, CA
  77.      Issued with ZCPR33-only type-3 version.  No changes.
  78.  
  79. Version 1.2 -- July 1986 -- Rob Friefeld
  80.      Previous version wouldn't handle files with more than 999 
  81.      records.  This version is OK to BDOS limit of 8 meg.  0 
  82.      length files and non-existent files are now differentiated.  
  83.      Pauses when output fills 24 line screen.
  84.  
  85. Version 1.1 -- Rob Friefeld
  86.      Accepts ambiguous file spec, up to 255 matches.
  87.