FF.DOC - File Find Utility for OS/2 documentation.   Version 1.1

**   Author:        Carl Sturmer  MS04492
**   Environ:       OS/2 1.1  TOOLKT11  MS C 5.1
                    80386/20mhz
                    VGA
                    4mb. memory
                    2ea. 40mb Seagates 1 to 1 interleave
                    1ea. 3.5  1.44mb floppy
                    1ea. 5.25 1.2mb floppy
**   Syntax:        C:>FF [drive:]filename.ext   [drive: is optional]
**   Version:       1.1
**   History:       89.0604 Created.
**                  89.0608 Corrected file size and file time reporting.
**   App.Type:      Text mode FAPI  (not bound due yet)
**   Distribution:  Placed in the Public Domain via MS-ONLINE
**   Restrictions:  This utility is not to be used in manner that would
                    provide monitary profit as a result of its distribution.


**   Limitations:   The syntax for running FF.EXE is restrictive with
                    this version.  I wrote it in a day and a half, with
                    alot of time spent sifting through the Programmers 
                    Ref.  You are not able to give a path on the command
                    line when running the program or you will get unexpected
                    results. (usually no finds).  This will be improved
                    with in the next few weekends.  Below are the typical
                    methods for running FF.



**   Usage:         FF *.exe

                       This defaults to the current drive and starts at
                       the root directory for the search.  All typical
                       DOS / OS/2 wildcards are supported for either the
                       filename and/or the extension.  This particular call
                       will find all the files with an extension of
                       .EXE on the current drive.
                        

                    FF d:pm*.*

                       This will go to drive d: and start at the root
                       directory for the search.  This call will find 
                       all the files that start with the letters  pm  and
                       have any extension.  Note that the drive must be
                       follow with a colon and no space between the colon   
                       and the file name.


                    FF c:PMGPI.PDF
        
                       This will find the file PMGPI.PDF on drive C: if it
                       exists.  It does not matter whether you use caps or
                       lower case for the file(s) to search for.


                    FF

                       This will produce an error message stating that you
                       did not supply a filename and also display the syntax
                       for FF.




**   Future Enhancements:

                    Within the next few weekends I will add the following
                    respectively:

                    1) Command line parsing.
                    2) Support subdirectory starts for searches.
                    3) Multiple drives to be specified on the command
                       line and searched simultaniously.  The contents of
                       the finds or lack of will be displayed in separate
                       windows on the screen. ie multitasking, what OS/2
                       is all about.
                    4) Dynamic filename length support. (to meet with MS's
                       notification that filename lengths will change in
                       future releases of OS/2 and can be longer than
                       8 characters for the filename and 3 characters for
                       the extension).                    
                    5) Add dynamic screen size support. ie greater than
                       80 character width and 25 character height displays.
                    6) Sensing for FF running in a PM text window, and
                       adjusting display to match window size where possible.




**   About the Display:

                    The following is the columns that are display on the
                    screen while running FF:


** PROGRAM NAME *********************  TITLE ********************** AUTHOR **

DIRECTORY (currently being searched)

    FILENAME.EXT                          FILESIZE  DATE  TIME  ATTRIBUTES
         "                                    "       "     "       "
         "                                    "       "     "       "
         "                                    "       "     "       "
         "                                    "       "     "       "
                                              
PROMPT  (continue, abort or number of finds at the end)
PROMPT  (press any key to close process)


        NOTE1: ATTRIBUTES are provided via a one letter description of
               the files current attribute settings.  The letters are
               shown below:

               N  =  NORMAL      - a normal file
               R  =  READONLY    - file is read only
               H  =  HIDDEN      - file is hidden
               S  =  SYSTEM      - file is a system file
               A  =  ARCHIVE     - archive bit is set

               If an attribute is set you will see it's letter appear, if
               the attribute is not you will see a dash  -.  The attribute
               letter are always diplayed in the same order ie.   NRHSA.
               A file with only normal and archive attributes would be 
               displayed as  N----A.
               


        NOTE2:(press any key to close process) is provided for
              running FF in a PM text window, with the PM window
              started from the StartPrograms App.  Without this
              facility the window would close before you could
              see how many finds FF made.  That is if you have 
              FF's PM text window set to close on finish.




**   Bug Reports:

                    If you run across any bugs or inconsistencies in the
                    user interface please drop me a line via a QuickComm
                    and address them to MS04492.
                    Please note that I am aware that the file count may
                    not match what CHKDSK or Norton Utilities returns and
                    this is primarily due to the fact that CHKDSK is able
                    to spot a couple of attributed files that I have not
                    found the attribute for in the DosFindNext() call.
                    As far as Norton Utilities I will return the same count
                    for all but an FF *.* or an FF .  This is because I don't
                    count directories as files and will not report a
                    directory find.  I found that usually when I am searching
                    for a file I wasn't looking for a directory, I wanted the
                    files only. (This could change in a future release)
                
