home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / fileutil / filefind / ff2 / ff.doc next >
Encoding:
Text File  |  1989-06-08  |  7.0 KB  |  158 lines
  1. FF.DOC - File Find Utility for OS/2 documentation.   Version 1.1
  2.  
  3. **   Author:        Carl Sturmer  MS04492
  4. **   Environ:       OS/2 1.1  TOOLKT11  MS C 5.1
  5.                     80386/20mhz
  6.                     VGA
  7.                     4mb. memory
  8.                     2ea. 40mb Seagates 1 to 1 interleave
  9.                     1ea. 3.5  1.44mb floppy
  10.                     1ea. 5.25 1.2mb floppy
  11. **   Syntax:        C:>FF [drive:]filename.ext   [drive: is optional]
  12. **   Version:       1.1
  13. **   History:       89.0604 Created.
  14. **                  89.0608 Corrected file size and file time reporting.
  15. **   App.Type:      Text mode FAPI  (not bound due yet)
  16. **   Distribution:  Placed in the Public Domain via MS-ONLINE
  17. **   Restrictions:  This utility is not to be used in manner that would
  18.                     provide monitary profit as a result of its distribution.
  19.  
  20.  
  21. **   Limitations:   The syntax for running FF.EXE is restrictive with
  22.                     this version.  I wrote it in a day and a half, with
  23.                     alot of time spent sifting through the Programmers 
  24.                     Ref.  You are not able to give a path on the command
  25.                     line when running the program or you will get unexpected
  26.                     results. (usually no finds).  This will be improved
  27.                     with in the next few weekends.  Below are the typical
  28.                     methods for running FF.
  29.  
  30.  
  31.  
  32. **   Usage:         FF *.exe
  33.  
  34.                        This defaults to the current drive and starts at
  35.                        the root directory for the search.  All typical
  36.                        DOS / OS/2 wildcards are supported for either the
  37.                        filename and/or the extension.  This particular call
  38.                        will find all the files with an extension of
  39.                        .EXE on the current drive.
  40.                         
  41.  
  42.                     FF d:pm*.*
  43.  
  44.                        This will go to drive d: and start at the root
  45.                        directory for the search.  This call will find 
  46.                        all the files that start with the letters  pm  and
  47.                        have any extension.  Note that the drive must be
  48.                        follow with a colon and no space between the colon   
  49.                        and the file name.
  50.  
  51.  
  52.                     FF c:PMGPI.PDF
  53.         
  54.                        This will find the file PMGPI.PDF on drive C: if it
  55.                        exists.  It does not matter whether you use caps or
  56.                        lower case for the file(s) to search for.
  57.  
  58.  
  59.                     FF
  60.  
  61.                        This will produce an error message stating that you
  62.                        did not supply a filename and also display the syntax
  63.                        for FF.
  64.  
  65.  
  66.  
  67.  
  68. **   Future Enhancements:
  69.  
  70.                     Within the next few weekends I will add the following
  71.                     respectively:
  72.  
  73.                     1) Command line parsing.
  74.                     2) Support subdirectory starts for searches.
  75.                     3) Multiple drives to be specified on the command
  76.                        line and searched simultaniously.  The contents of
  77.                        the finds or lack of will be displayed in separate
  78.                        windows on the screen. ie multitasking, what OS/2
  79.                        is all about.
  80.                     4) Dynamic filename length support. (to meet with MS's
  81.                        notification that filename lengths will change in
  82.                        future releases of OS/2 and can be longer than
  83.                        8 characters for the filename and 3 characters for
  84.                        the extension).                    
  85.                     5) Add dynamic screen size support. ie greater than
  86.                        80 character width and 25 character height displays.
  87.                     6) Sensing for FF running in a PM text window, and
  88.                        adjusting display to match window size where possible.
  89.  
  90.  
  91.  
  92.  
  93. **   About the Display:
  94.  
  95.                     The following is the columns that are display on the
  96.                     screen while running FF:
  97.  
  98.  
  99. ** PROGRAM NAME *********************  TITLE ********************** AUTHOR **
  100.  
  101. DIRECTORY (currently being searched)
  102.  
  103.     FILENAME.EXT                          FILESIZE  DATE  TIME  ATTRIBUTES
  104.          "                                    "       "     "       "
  105.          "                                    "       "     "       "
  106.          "                                    "       "     "       "
  107.          "                                    "       "     "       "
  108.                                               
  109. PROMPT  (continue, abort or number of finds at the end)
  110. PROMPT  (press any key to close process)
  111.  
  112.  
  113.         NOTE1: ATTRIBUTES are provided via a one letter description of
  114.                the files current attribute settings.  The letters are
  115.                shown below:
  116.  
  117.                N  =  NORMAL      - a normal file
  118.                R  =  READONLY    - file is read only
  119.                H  =  HIDDEN      - file is hidden
  120.                S  =  SYSTEM      - file is a system file
  121.                A  =  ARCHIVE     - archive bit is set
  122.  
  123.                If an attribute is set you will see it's letter appear, if
  124.                the attribute is not you will see a dash  -.  The attribute
  125.                letter are always diplayed in the same order ie.   NRHSA.
  126.                A file with only normal and archive attributes would be 
  127.                displayed as  N----A.
  128.                
  129.  
  130.  
  131.         NOTE2:(press any key to close process) is provided for
  132.               running FF in a PM text window, with the PM window
  133.               started from the StartPrograms App.  Without this
  134.               facility the window would close before you could
  135.               see how many finds FF made.  That is if you have 
  136.               FF's PM text window set to close on finish.
  137.  
  138.  
  139.  
  140.  
  141. **   Bug Reports:
  142.  
  143.                     If you run across any bugs or inconsistencies in the
  144.                     user interface please drop me a line via a QuickComm
  145.                     and address them to MS04492.
  146.                     Please note that I am aware that the file count may
  147.                     not match what CHKDSK or Norton Utilities returns and
  148.                     this is primarily due to the fact that CHKDSK is able
  149.                     to spot a couple of attributed files that I have not
  150.                     found the attribute for in the DosFindNext() call.
  151.                     As far as Norton Utilities I will return the same count
  152.                     for all but an FF *.* or an FF .  This is because I don't
  153.                     count directories as files and will not report a
  154.                     directory find.  I found that usually when I am searching
  155.                     for a file I wasn't looking for a directory, I wanted the
  156.                     files only. (This could change in a future release)
  157.                 
  158.