home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / ZSUS002.LBR / Z3HELP21.LBR / FF.HZP / FF.HLP
Text File  |  2000-06-30  |  8KB  |  158 lines
  1. ;
  2.                                      FF.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (24)   D4A8  2.2        Howard Goldstein 1/90    Z3COM3 
  6.  
  7.   1- Syntax  2- Configuration  3- Notes                                       
  8.  
  9.    FF is  a File-Find utility derived  from FINDF version 2.6.   It finds  all
  10. files matching a list of file specs on all drives, a specific drive, or a list
  11. of drives.  All file specs are automatically made wild (that is, "A.B" becomes
  12. "A*.B*").
  13.  
  14.    A configuration word at the beginning of the code contains a  byte for each 
  15. possible drive in a system.   When the user has not indicated a specific drive
  16. to scan, each drive is checked against this table and  skipped  if  the bit is 
  17. not set.  This allows FF to work in systems with holes (e.g., drives A, B, and
  18. F) in which the BIOS hangs when a drive is accessed that does not exist or has
  19. no disk. 
  20. :1
  21.    Syntax   FF [D: or DIR:]afn[,afn]... [d...][/o...]
  22.  
  23.   Options   (d) before slash:
  24.             list of drivers to scan
  25.  
  26.   Options   (o) after slash:
  27.             E - Exact matches only (no auto wildcarding)
  28.             P - No Paging of output
  29.             S - Include SYS files (Wheel byte must be set)
  30.   
  31.    Error flag is set to 0ffh if no  matching files  are found,  or to 1 if the 
  32. program is aborted by the user.  The number of matching files found  is put in
  33. a register (see "Configuration").
  34.  
  35.    Auto-scanned drives are: ABCDEFGHIJKLMNOP  (see "Configuration")
  36.  
  37.    Output  can  be  paged a line at a time by hitting the space bar or  can be 
  38. aborted at a page break by hitting CTRL-C.
  39.  
  40.    All file specs are ambiguous (FF A = FF A*.*, FF A.B = FF A*.B*, etc.). 
  41. :2
  42.  Configuration 
  43.  
  44.    In the first record of the COM file are  three  ASCII labels for configura-
  45. tion of FF.   The labels can  be easily seen using a patching utility, such as
  46. ZPATCH, to configure the bytes immediately following each label.
  47.  
  48.    DRVTBL     Two bytes follow this label with  each  bit  corresponding to  a 
  49.               drive (A-P) to be automatically scanned if no  drives  are given
  50.               on the command line.   Drives  are scanned if the  corresponding 
  51.               bit is set to (1).
  52.  
  53.    REG#       This byte sets the register number where  the number of matching
  54.               files found is recorded.  The default is 0, but you can patch in
  55.               any file number 0-9.   A number greater than 9 will disable this
  56.               feature.
  57.  
  58.    SYSF       System files will be included by default if  this  byte  is non-
  59.               zero, provided the Wheel byte is set.  If this byte or the Wheel
  60.               byte is  zero,  system  files  are  excluded.   The  "S"  option 
  61.               reverses the meaning of this byte.
  62.  
  63.                                  FFPATCH.ASM 
  64.  
  65.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  66.                1k (2)    4AF3  n/a        Gene Pizzetta 12/89      Z3COM3
  67. ==============================================================================
  68.  
  69.    FFPATCH is a simple patch to set the drive vector in FF (Find File).   Edit
  70. it to reflect your system's drive arrangement, assemble it with just about any
  71. assembler to a HEX file, and then MLOAD it over your copy of FF.COM.
  72. :3
  73.  FF Notes - 1/5 
  74.  
  75.    a. A program error flag is  set if no files  are found  and  cleared if the
  76.       files are found.   The  nr of  files found  is stored in  a configurable 
  77.       user register.  If the nr is more than 255, the value 255 is stored.
  78.  
  79.    b. Version 2.2 updates (1/12/90):
  80.       - Exit logic modified so that nr of files found is placed in the 
  81.       register even when the program is aborted by the user.  The error flag
  82.       is set to 1 on user abort.
  83.       - Further code crunching to get program back down to 3k.  
  84.       - Logic fixed to allow one more line on first screen of paged output. 
  85.  
  86.    c. Version 2.1 updates (12/30/89):
  87.       - Adds configuration  byte to include or  exclude  SYStem  files  as the
  88.       default.   A non-zero  value  causes files  to be included, but the byte 
  89.       will be ignored  if the  wheel byte is  off).   "S" option  now  toggles 
  90.       current default.   Help screen modified to reflect default setting.  New
  91.       doc file includes revision history from source.
  92.  FF Notes - 2/5 
  93.  
  94.    d. Version 2.0 updates (11/26/89):
  95.       - Fixes bug which caused  duplicate  listing  of  files  larger  than 32
  96.       32 extents.
  97.  
  98.    e. Version 1.9 updates (03/18/89):
  99.       - Release version.  Result of general code cleanup.
  100.  
  101.    f. Version 1.8 updates (03/09/89):
  102.       - Corrects check  against MAXDRV byte  in  the  environment  descriptor.  
  103.       Previous code  allowed one  drive  beyond  MAXDRV.   Extracts  new  MASK 
  104.       routine from INIT so that it  can  be called after any drive options are 
  105.       processed.   This enforces the  valid  drive vector from the environment 
  106.       descriptor regardless of the setting of the MAXDRV byte.
  107.   
  108.    g. Version 1.7 updates (03/04/89):  
  109.       - Fixes bug which caused 'FF /' command to list all files.  Only 'FF' or
  110.       'FF,<one or  more  spaces>//'  (exactly)  now  gives  help.   'FF /'  or 
  111.       'FF // ' are intrepreted as filespecs.
  112.  FF Notes - 3/5 
  113.  
  114.    h. Version 1.6 updates (03/02/89): 
  115.       - Changes page prompt to reflect multiple abort keys (says 'RETURN=page'
  116.       instead  of 'OTHER=page').   Help is  no  longer  generated  by a single 
  117.       slash as a parameter,  allowing files  beginning with '/' to be searched 
  118.       for.
  119.  
  120.    i. Version 1.5 updates (02/26/89):
  121.       - Adds REG# ASCII pointer to  the patch  byte controlling which register 
  122.       is used to store the  number  of matches found.   The  default  is zero.  
  123.       Register is changed  by substituting  a BINARY value from 1 to 9 at this 
  124.       storage location.
  125.  
  126.    j. Version 1.4 updates (02/23/89):
  127.       - Allows abort with  ^c, c, C, ^k, k, K, ^x, x, or X  between  pages  of 
  128.       paged output.  System valid drive vector is now logically ANDed with the 
  129.       table in the program.
  130.  FF Notes - 4/5 
  131.  
  132.    k. Version 1.3 updates (07/04/88):
  133.       - Exits with BIOS, then BDOS drive-select.
  134.  
  135.    l. Version 1.2 updates (02/29/88):
  136.       - Adds extended environment valid-drive vector.
  137.  
  138.    m. Version 1.1 updates (11/14/87):
  139.       - Adds compatibility with CPM/3 and DosDisk.  
  140.       - Converts directory searches  to  BDOS  calls,  for  compatibility with 
  141.       DosDisk and other BDOS emulators.   
  142.       - Removes IX register use, for compatibility  with BIOS/DOS systems that 
  143.       mistakenly fail to preserve Z80 registers.  
  144.       - Adds check for presence of external environment.   
  145.       - Uses full TPA if CCP is protected.   Search  every  valid  BIOS  drive 
  146.       whose bit is  set  in  the  DRVTBL (previous  versions  aborted on first 
  147.       invalid drive).
  148.  FF Notes - 5/5 
  149.  
  150.    n. Version 1.0 (03/14/88):
  151.       - Adds DRVTBL configuration word at  beginning of code which contains  a
  152.       byte for each possible drive in a system.   As distributed, FF has FFFFh 
  153.       in this word so that all drives up to  the  max drive specified  in  the 
  154.       environment will be scanned.  
  155.       - Output can now be paged a line at  a time  by hitting the space bar or 
  156.       can be aborted at a page break by hitting ^C.
  157.       - Enhanced syntax allows specifying  a list  of drives to  be scanned in 
  158.       the option field.