*------------------------------------------------------------------*
|    NAME:     FF (FINDFILE)                                       |
|    FUNCTION: File finder                                         |
*------------------------------------------------------------------*

Once again, this is really  FINDFILE,  yet  another  file  searching
program  a  la  WHEREIS,  FILEFIND, etc.  My very own version, shows
date and time in real Aussie format.  (Allows  hidden  files,  etc.)

USAGE: FF [/options] [[d:][path][filespec] ... ]

Note that multiple filespecs may be included on each command line.
e.g. FF/W/P C:\X*.XYZ B:  (uses X*.XYZ from current directory on B:)

/A - Archive files only
Only  files  with the 'a' (archive) attribute will be matched.  i.e.
this option will list only those files which have not been backed-up
with BACKUP, XCOPY /M or similar archiving program.

/B - Bytes for filesize
Shows  filesizes  to exact byte value, irrespective of size, instead
of rounding up if filesize is over 65535 bytes.

/D - Directories only
Only  Subdirectory entries (i.e no files) will be matched.
However, see note regarding combined options

/F - Files only
Only files (i.e. no subdirectories) will be matched if  this  option
is selected.  Overrides the /D directory option.

/H - Hidden/System files only
Only subdirectory entries or files with the 'h' (hidden file) or 's'
(system file) attribute will be matched.
However, see note regarding combined options

/N - No unused paths displayed
Normally,  screen  output contains repeated carriage returns without
linefeeds as paths are searched.  This results  in  overprinting  or
excessive  file lengths with redirection.  To limit path displays to
only those containing matched files, use the /N option.

/P - Pause each page
This option will cause the output to be suspended at the end of each
full screen.  Very useful on faster PCs.

/R - R/O files only
Only  subdirectory  entries  and  files  with  the  'r'  (R/O  file)
attribute will be matched.
However, see note regarding combined options

/T - Totals count only
Only the counts will be given - subdirectories and files will not be
shown

/W - Wide display
Only subdirectory and file names will be shown, 5 per line

/? - Help display
Shows the options available

/B:dd/mm/yy - newest date "Before"
This  option  allows  a  newest  date  to be specified.  Any file or
sub-directory of newer date will not be displayed.  Format  for  the
date  must  be  /B:dd/mm/yy  and  have  a  trailing  space  if other
parameters follow.  e.g. FF /B:31/12/92 *.asm

/D:dd/mm/yy - oldest date "Dated"
This option allows an oldest date to  be  specified.   Any  file  or
sub-directory of earlier date will not be displayed.  Format for the
date  must  be  /D:dd/mm/yy  and  have  a  trailing  space  if other
parameters follow.  e.g. FF /D:1/1/92 *.asm
When combined with the /B:date option, this allows display of only a
restricted date range.  e.g. FF  /B:31/12/92  /D:1/1/92  *.asm  will
only list *.ASM files with date ranges in 1992.

This option does not affect the status of the /D option.


Notes: Options  A,D,H & R select ANY matching  attribute,  not  all.
Hence  the  /D  option alone will match only subdirectory names, but
the  /D/H  option  will  also   find   hidden   or   system   files.
Subdirectories '.' and '..' are not shown.

The output can be paused at any time by pressing any key.  A  second
keypress  restarts  the  output.   This  action also resets the page
counter if the /P option is in effect. <ESC> aborts FF.

Hint: to get single line outputs, touch the <SPACE> bar as  soon  as
the  program  starts.   Then restart the output by pressing any <Fn>
key.   The  function  keys  generate  two  "keystrokes"   in   quick
succession, resulting in an immediate stop at the next output.


On Exit from FF, the ERRORLEVEL will be set to:

      0 if No files found
      1 if files were found
      2 if /? Help was requested
      3 if an Error was detected in the command or program


FF  now  automatically  detects  display lines count and changes the
number of lines per paged display to suit.  Each display page  shows
1 line less than the lines per page.

The filespec now uses the ambiguous format "x*" conversion to "x*.*"


Author:         Howard Harvey (hjh@gwd.dsto.gov.au)
Release Date:   5/MAY/94

