home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help11.lbr / FF.HZP / FF.HLP
Encoding:
Text File  |  1993-06-12  |  3.8 KB  |  88 lines

  1. ;
  2.                                      FF.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (25)   AB21  1.9        Carson Wilson 3/89       Z3COM3 
  6.  
  7.   1- Syntax  2- Notes                                                         
  8.  
  9.  
  10.    FF is a File-Find utility derived from FINDF version 2.6.   A configuration 
  11. word at the beginning of the code contains a byte for each possible drive in a 
  12. system.   When the user has not indicated a specific drive to scan, each drive 
  13. is checked against this table and skipped if the bit is not set.   This allows 
  14. FF to work in systems with holes (e.g.,  drives A, B, and F) in which the BIOS 
  15. hangs when a drive is accessed that does not exist or has no disk. 
  16.  
  17. :1
  18.  
  19.    Syntax:  FF [D: or DIR:]afn[,afn].. [d..][o/..]
  20.  
  21.   Options:  (d) before slash:
  22.             list of drivers to scan
  23.  
  24.   Options:  (o) after slash:
  25.             E - Exact (no auto wildcarding)
  26.             P - No Paging
  27.             S - Include SYS files
  28.   
  29.    Error flag is set if no files are found.  Number of files are put in REG 0.
  30.    Auto-scanned drives are: ABCDEFGHIJKLMNOP.
  31.  
  32.    Output  can  be paged a line at a time by hitting the space bar or  can be 
  33. aborted at a page break by hitting CTRL-C.
  34.  
  35.    All file specs are ambiguous (FF A = FF A*.*, FF A.B = FF A*.B*, etc.). 
  36. :2
  37.  
  38.  
  39. FF Notes:
  40.  
  41.    a. A program error flag is  set if no files  are found  and  cleared if the
  42.       files are found.   The  nr of  files found  is stored in  a configurable 
  43.       user register.  If the nr is more than 255, the value 255 is stored.
  44.  
  45.    b. Version 1.8  corrects  check  against  MAXDRV  byte in  the  environment
  46.       descriptor.   Previous code  allowed  one drive beyond MAXDRV.  Extracts
  47.       new MASK routine from INIT so  that it  can  be  called  after any drive
  48.       options are processed.   This enforces  the valid drive vector  from the
  49.       environment descriptor regardless of the setting of the MAXDRV byte.
  50.   
  51.    c. Version 1.7  fixes  bug  which  caused 'FF /' command to list all files.
  52.       Only  'FF'  or  'FF,<one or more spaces>//' (exactly)  now  gives  help.
  53.       'FF /' or 'FF // ' are intrepreted as filespecs.
  54.  
  55.  
  56.  
  57. FF Notes (cont'd):
  58.  
  59.    d. Version 1.6  changes  page  prompt  to reflect multiple abort keys (says
  60.       'RETURN=page' instead  of 'OTHER=page').  Help is no longer generated by
  61.       a single slash as  a parameter,  allowing files beginning with '/' to be
  62.       searched for.
  63.  
  64.    e. Version 1.5 adds REG# ASCII pointer to  the patch byte controlling which
  65.       register is used to store the number of matches found.   The  default is
  66.       zero.  Register is changed by substituting a BINARY value from 1 to 9 at
  67.       this storage location.
  68.  
  69.    f. Version 1.4  allows  abort  with ^c, c, C, ^k, k, K, ^x, x, or X between
  70.       pages of paged output.  System valid drive vector is now logically ANDed
  71.       with the table in the program.
  72.  
  73.    g. Version 1.3 exits with BIOS, then BDOS drive-select.
  74.  
  75.  
  76.  
  77. FF Notes:
  78.  
  79.    h. Version 1.2 adds extended environment valid-drive vector.
  80.  
  81.    i. Version 1.1  adds  compatibility  with  CPM/3  and  DosDisk.    Converts 
  82.       directory searches to BDOS  calls,  for  compatibility with DosDisk  and
  83.       other BDOS emulators.   Removes IX register use,  for compatibility with
  84.       BIOS/DOS systems that mistakenly fail  to preserve Z80 registers.   Adds
  85.       check  for presence  of external environment.   Uses full TPA  if CCP is
  86.       protected.   Search  every  valid  BIOS  drive  whose bit  is set in the 
  87.       DRVTBL (previous versions aborted on first invalid drive).
  88.