home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / fff45.zip / FFF.DOC < prev    next >
Text File  |  1993-12-28  |  65KB  |  1,399 lines
  1.  
  2.                                    File Finder Pack
  3.                                      Version 4.5
  4.                                        12-27-93
  5.                                           by
  6.                                        Jim Derr
  7.  
  8.                                       Member of
  9.                         Association of Shareware Professionals
  10.                                  CSERVE ID 76266,2634
  11.  
  12.  
  13.         HARDWARE SOFTWARE REQUIREMENTS  . . . . . . . . . . . . . . . . . .  3
  14.  
  15.         QUICK START . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  16.  
  17.         PERFORMING A FUZZY SEARCH . . . . . . . . . . . . . . . . . . . . .  4
  18.  
  19.         CONFIGURING THE FFF.EXE ,FFD.EXE, and FF2.COM PROGRAMS  . . . . . .  5
  20.  
  21.         MEMORY USAGE IN THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . .  6
  22.  
  23.         FF2 PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  24.  
  25.         FFF PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  26.  
  27.         FFF HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  28.  
  29.         MODIFYING THE FFF FILE LISTING FORMAT . . . . . . . . . . . . . . . 20
  30.  
  31.         MODIFYING THE FFF PRINT FORMAT  . . . . . . . . . . . . . . . . . . 21
  32.  
  33.         FFD PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  34.  
  35.         SMART LAUNCH FEATURE  . . . . . . . . . . . . . . . . . . . . . . . 25
  36.  
  37.         MEMORY SWAPPING OPTION IN FFF . . . . . . . . . . . . . . . . . . . 25
  38.  
  39.         MONOCHROME MONITORS . . . . . . . . . . . . . . . . . . . . . . . . 25
  40.  
  41.         MISC. INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . 25
  42.  
  43.         THE SGREP PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . 27
  44.  
  45.         REGULAR EXPRESSIONS . . . . . . . . . . . . . . . . . . . . . . . . 29
  46.  
  47.         REVISION HISTORY  . . . . . . . . . . . . . . . . . . . . . . . . . 30
  48.  
  49.         INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
  50.  
  51.  
  52.                           FileFinder Version 4.5 User Manual           Page-3-
  53.  
  54.         This  is a  shareware product.    If you  find these  utilities useful
  55.         please register and keep shareware alive.   Only registered users will
  56.         be supported..
  57.  
  58.                             HARDWARE SOFTWARE REQUIREMENTS
  59.  
  60.         FF2, FFF, and FFD can  be run on any DOS  based PC having a CGA,  MDA,
  61.         EGA, VGA, or HERC monitor.
  62.         The DOS  operating system must be  3.1 or greater.   Both program will
  63.         also operate correctly  in the DOS  compatibility box  of OS/2 1.2  or
  64.         greater.  Token ring networks or Novell networks are also supported.
  65.         DOS memory  requirements range from a  low of 160K  to a high  of 400K
  66.         depending on how the FFF program is configured.
  67.  
  68.                                      QUICK START
  69.         The  FF2 program  performs file  search operations  and will  show the
  70.         results on the screen or the output can be redirected to a file.
  71.  
  72.         The  FFF program performs file search  operations and will display the
  73.         results on the screen in a scrollable window.  Numerous operations can
  74.         then be performed on user selected files.
  75.  
  76.         The FFD program performs directory search operations and  will display
  77.         the results on the screen in a scrollable window.
  78.  
  79.         FF2, FFF, and  FFD use basically the same format  for the command line
  80.         option.  All command line  parameters MUST be separated by  blanks and
  81.         all options MUST begin with a forward slash /.  The options may appear
  82.         anywhere  on  the command line.   The format  of the command  line for
  83.         both programs is:
  84.  
  85.         FFx [options]  [[drives:] [filespec]] [options]
  86.  
  87.         If the drives  parameter is omitted the programs will  search all hard
  88.         drives that can  be identified.  If  the drives parameter is  included
  89.         then  only the  drives specified  will be  searched. (PLEASE  NOTE THE
  90.         COLON MUST BE ENTERED AFTER THE DRIVE LETTERS).
  91.  
  92.  
  93.                           FileFinder Version 4.5 User Manual           Page-4-
  94.  
  95.                               PERFORMING A FUZZY SEARCH
  96.  
  97.         Both FF2 and FFF  can also perform a fuzzy search.   This is useful if
  98.         you are trying  to locate a  file but don't  know the exact  filename.
  99.         The  fuzzy search routine will attempt to locate files that sound like
  100.         the filename entered on the command line.  To indicate that you want a
  101.         fuzzy search performed place the ~ character in front of the filename.
  102.         PLEASE NOTE: WHEN  PERFORMING A  FUZZY SEARCH  DO NOT  INCLUDE A  FILE
  103.         EXTENSION.  See the examples below.
  104.  
  105.         If the colon is entered without any drive letter preceding it then FFF
  106.         and FF2 will only search for files on the current default disk drive.
  107.  
  108.         For example:
  109.  
  110.         FFF : *.bat
  111.  
  112.         This will  search for all files on the current default drive that have
  113.         a file extension of bat.
  114.  
  115.         Multiple  filespecs may be  entered along  with multiple drives.   For
  116.         example:
  117.  
  118.         FF2  *.BAK CD: \UTILITY\*.COM  DE: \TEMP\*.*  C:\JIM\*.*
  119.  
  120.         This example will:
  121.         1)   Find all  files that have a file extension of BAK that resides on
  122.              any identifiable hard drive.
  123.  
  124.         2)   Find all files that have  a file extension of COM in  the UTILITY
  125.              directory  or any sub-directory of  the UTILITY directory ONLY ON
  126.              HARD DRIVES C AND D.
  127.  
  128.         3)   Find all  files that  reside in  the TEMP  directory or any  sub-
  129.              directory of the TEMP directory ONLY ON HARD DRIVES D AND E.
  130.  
  131.         4)   Find all  files that  reside  in the  JIM directory  or any  sub-
  132.              directory of the JIM directory ONLY ON THE C DRIVE.
  133.  
  134.         FFF  ~QRT
  135.  
  136.         Perform a  fuzzy search looking for  all files that sound  like qtr on
  137.         all drives.
  138.  
  139.         FFF  ~QTR  *.COM
  140.  
  141.         Perform  the same fuzzy  search as above, in  addition locate all .COM
  142.         files.
  143.  
  144.         Any options that appear on the  command line are active for all search
  145.         operations.
  146.  
  147.  
  148.                           FileFinder Version 4.5 User Manual           Page-5-
  149.  
  150.                 CONFIGURING THE FFF.EXE ,FFD.EXE, and FF2.COM PROGRAMS
  151.  
  152.         The FF series  of   programs have numerous  configurable options.   To
  153.         configure the programs  the configuration program  FFFCFG.EXE must  be
  154.         run.  Simply enter FFFCFG at the DOS command prompt and the answer the
  155.         questions as  they appear.  The FFFCFG  program will create an FFF.CFG
  156.         file that  is used by  all FF programs.   THE  FFF.CFG FILE SHOULD  BE
  157.         MOVED INTO A DIRECTORY THAT IS LOCATED IN YOUR DOS PATH.
  158.  
  159.         When the CTRL-ENTER keys are pressed FFF can execute a user defined
  160.         program against the currently highlighted file based on the file
  161.         extension.  Up to THREE sets of file extensions and program names
  162.         can be defined.
  163.  
  164.         When prompted for an extension list enter the file extensions you wish
  165.         to operate on, each extension MUST have a period preceding the
  166.         extension, i.e.  EXT1=.ZIP.LZH.ZOO
  167.  
  168.         When prompted for the program to execute, please include the full path
  169.         and  use the ! character to indicate where to substitute the filename,
  170.         i.e.  PGM1=C:UTILITYSHEZ.EXE !
  171.  
  172.  
  173.                           FileFinder Version 4.5 User Manual           Page-6-
  174.  
  175.                          MEMORY USAGE IN THE FFF.EXE PROGRAM
  176.  
  177.         The  FFFCFG program now allows you set  the number of files and unique
  178.         directories that  the FFF program can  handle.  The FFF  program comes
  179.         pre-configured  to handle 3000  files and 300  unique directory names.
  180.         Under this configuration  the FFF program  uses approximately  317,000
  181.         bytes of memory.  If you increase or decrease the  number of files FFF
  182.         can handle it's  memory usage increases or  decreases by 49  bytes for
  183.         each additional file you tell FFF to handle.
  184.  
  185.         If you increase  or decrease the number of  unique directory names FFF
  186.         can handle its memory usage increases or decreases by 70 bytes.
  187.  
  188.         To  determine the amount  of memory FFF  will need,  use the following
  189.         formula:
  190.  
  191.              149300 + (49 * number of files  to handle) + (70 * number of dirs
  192.              to handle)
  193.  
  194.         For example, the memory requirements for FFF to handle 5000 files  and
  195.         400 unique directories would be:
  196.  
  197.              149300 + (49 * 5000) + (70 * 400) = 422,300
  198.  
  199.         The FFF program will automatically use EMS memory if it  is available.
  200.         EMS  memory will be  used to store  directory information thus freeing
  201.         conventional memory allowing FFF to handle more file names.
  202.  
  203.  
  204.                           FileFinder Version 4.5 User Manual           Page-7-
  205.  
  206.                                      FF2 PROGRAM
  207.         This program will find files on your hard disk.  It as fashioned after
  208.         the whereis program but has more features.
  209.  
  210.         Format is:
  211.  
  212.         FF2 [options] [[drives:] [filespec]] [options]
  213.  
  214.         Where options are:
  215.         /C        comma delimited listing
  216.         /R        raw listing - full path name only
  217.         /S        short listing - filename.ext only
  218.         /B        list in bat file format
  219.         /P        pause when screen is full
  220.         /Q        quite mode
  221.         /I        also look inside archive files
  222.         /A        only look inside archive files
  223.         /E        Extended Directory Search
  224.         /G        Greater or Equal to mm-dd-yy
  225.         /L        Less or Equal to mm-dd-yy
  226.         /=        Equal to mm-dd-yy
  227.         /SD       Single Directory search only (do not recurse)
  228.         /1        stop after finding one file
  229.                   errorlevel 1 returned if no files found
  230.                   errorlevel 0 returned if files are found
  231.         /Z[RHSA]  Show files with specified attributes
  232.         /X"cmd"   execute a cmd against all files found
  233.         /@        Prompt for options.
  234.         /NN       No-Network drive search
  235.         /LN       Look for network drives
  236.         /!        Exclude files that match specified pattern
  237.         /w        Find  files that were created or  modified on a specific day
  238.                   of the week.
  239.         /t        Find files that contain a specified text string.
  240.  
  241.         The filespec's  that are specified  on the command line  can include a
  242.         disk  and directory. If a disk and  or directory is specified than the
  243.         search  will be restricted to the specified disk and directory and any
  244.         sub-directories under  the specified  directory.   Each  filespec  can
  245.         contain different starting disks and directories.
  246.  
  247.         When  specifying  the file  to  search for  FF2  has a  quick complete
  248.         algorithm.  If you do not include a period in the file ex   tension
  249.         FF2 will expand  the filespec using the  wildcard character ?  for the
  250.         remainder  of the filespec.   For example  if you entered  FF2 AB, FF2
  251.         will expand the filespec  to AB??????.???.  If you enter  FF2 C:\BAT\B
  252.         FF2  will expand the filespec to  C:\BAT\B???????.???.  However if you
  253.         enter FF2  B.* , FF2 will not alter  the filespec since you included a
  254.         period in the filespec.
  255.  
  256.         FF2 also has an expanded wild card search algorithm. If you include an
  257.         * on  both sides of  the filename,  FF2 will find  all files  that
  258.         contain  the  characters  entered  between the  *'s  anywhere  in  the
  259.         filename. For example:
  260.  
  261.         FF2 *inst*
  262.  
  263.         This will find all files that contain inst somewhere in the filename.
  264.  
  265.  
  266.                           FileFinder Version 4.5 User Manual           Page-8-
  267.  
  268.         I.E. D:\ANY\PINST.BAT
  269.              C:\ONE\PCINSTAL.BAT
  270.              C:\TWO\INSTALL.COM
  271.  
  272.         To find  files  with no  extension  include  the period  but  no  file
  273.         extension. I.E.  FF2 *me*.
  274.  
  275.         If no  disk or directory is  included with the filespec  than all hard
  276.         disks will be searched.
  277.  
  278.  
  279.                           FileFinder Version 4.5 User Manual           Page-9-
  280.  
  281.         FF2 now has the capability to automatically identify all hard disks on
  282.         your  system.  You  can over-ride this  automatic detection by setting
  283.         the environment variable FF to the disk letter your wish the search to
  284.         be performed on. For example.  SET FF=CD tells FF2 to search the C and
  285.         D drives if  you have  not specified  a disk  in the  filespec on  the
  286.         command line.
  287.  
  288.         All  output  from FF2  can be  redirected or  piped  by using  the DOS
  289.         redirect and pipe characters.
  290.  
  291.         The default output  produced by FF2  file-size, file-date,  file-time,
  292.         disk:\directory\filename.file-ext. This  can be  changed by  using the
  293.         following command line options:
  294.  
  295.         /C   Produces a comma  delimited listing, this listing can be imported
  296.              into most spreadsheet and database programs.
  297.  
  298.         /R   Produces a raw listing containing disk:\directory\fn.ext only.
  299.  
  300.         /S   Produces a short listing containing filename.ext only.
  301.  
  302.         /B   Produces a  listing that can be used as a bat file. The output is
  303.              as follows:
  304.              %1 filename.ext %2 %3 %4 %5 %6 %7 %8 %9
  305.  
  306.         /P   Will case a pause when the screen is full.
  307.  
  308.         /Q   Quite mode no output produced but results can be tested  by using
  309.              the if errorlevel command in a .bat file.
  310.  
  311.         /I   This option tells  FF2 to also look inside any  archive files for
  312.              the  indicated files.   The archive files  that are supported are
  313.              ZIP, ARC, ARJ, ZOO, PAK, LZH and SQZ files.
  314.  
  315.         /A   This option tells FF2 to  ONLY look inside archive files  for the
  316.              indicated files.
  317.  
  318.         /1   This  option tells FF2  to stop looking for  files after it finds
  319.              the first file that matches the specified pattern.
  320.  
  321.         /E   To increase the file search  process FF2 normally only looks  for
  322.              directories  that do not  contain a  file extension.   Using this
  323.              option  tells  FF2 to  also  look  for directories  that  contain
  324.              directory names with extensions.
  325.  
  326.         /G   This  option allows  you to limit  the file search  to files that
  327.              have a filedate Greater  than or Equal to the date specified. The
  328.              format is /Gmm-dd-yy.
  329.              I.E. /G01-01-90    or   /G1-1-90  will  list files  that  have  a
  330.              filedate greater than or equal to 1-1-90.
  331.              (Note this option may be combined with the /L option to specify a
  332.              date range)
  333.  
  334.         /L   This option allows  you to limit  the file  search to files  that
  335.              have a  filedate Less than  or Equal to  the date  specified. The
  336.              format is /Lmm-dd-yy.
  337.              I.E.  /L01-01-90   or    /L1-1-90 will  list  files that  have  a
  338.              filedate less than or equal to 1-1-90.
  339.              (Note this option may be combined with the /G option to specify a
  340.  
  341.  
  342.                           FileFinder Version 4.5 User Manual          Page-10-
  343.  
  344.              date range)
  345.  
  346.         /=   This option allows  you to  limit the file  search to files  that
  347.              have a filedate Equal to the  date specified. The format is /=mm-
  348.              dd-yy.
  349.              I.E.  /=01-01-90   or    /=1-1-90 will  list  files  that have  a
  350.              filedate to 1-1-90.
  351.  
  352.         /Z[RHSA]
  353.              This option allows  you to limit  the file  search to files  that
  354.              have specific attributes.  For  example, specifying /ZA will list
  355.              files that have the archive attribute, /ZRH  will list files that
  356.              have the read-only attribute OR the hidden attribute set.
  357.              ***PLEASE NOTE  IF YOU  SPECIFY THE  /A OR  /I OPTIONS THAN  THIS
  358.              OPTION IS IGNORED***
  359.  
  360.         /SD  This  option informs FF2  to only  search the directory  that was
  361.              specified on the command line  and not to search any  directories
  362.              that exist under the specified directory.
  363.  
  364.  
  365.                           FileFinder Version 4.5 User Manual          Page-11-
  366.  
  367.         /X"cmd"
  368.              This options  allows  you to  tell  FF2  to execute  a  specified
  369.              against all files that are found.
  370.              For Example:
  371.  
  372.              /X"del &"
  373.  
  374.              will execute the delete command against all file that were found.
  375.              The command can be any DOS command or another program.   FF2 will
  376.              insert the disk:\dir\fn.fext of  the found file into the  command
  377.              where you place the & character.
  378.  
  379.              For example if you specify the following:
  380.  
  381.              /X"grep any & -s"
  382.  
  383.              and  FF2  finds  the  file c:\data\any.doc  it  will  execute the
  384.              following command:
  385.  
  386.              grep any c:\data\any.doc -s
  387.  
  388.              If  you do  not  put the  & in  then  FF2 will  insert the  found
  389.              filespec at the first blank in the command you specify, or at the
  390.              end of the command if no blanks exist.
  391.  
  392.         /@   This  options instructs FF2  to prompt  the user for  the command
  393.              line parameters.  PLEASE NOTE NO OTHER PARAMETERS  ARE ALLOWED ON
  394.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  395.              option  also allows the user  to use the  DOS redirect feature to
  396.              feed FF2 it's parameters.
  397.  
  398.              For example:  FF2 /@ < FF2.DAT
  399.  
  400.              This  instructs FF2 to  read its  parameters from the  file names
  401.         FF2.DAT.
  402.  
  403.         /NN  This option allows you to bypass the searching of Network drives.
  404.              If  you configured FF2  to search for network  drives you may use
  405.              this option to temporarily bypass the network drive search.
  406.  
  407.         /LN  This option  allow you to search for files on Network drives.  If
  408.              you  configured FF2  to ignore  network drives  you may  use this
  409.              options to temporarily look for files on any networked drives.
  410.  
  411.         /!   This  option allows you  to exclude  files. Files that  match the
  412.              excluded  file pattern  will not be  listed.  For  example if you
  413.              entered the following command:
  414.              FF2  *.c /!f*.c
  415.              This would list all the files with a .C file extension EXCEPT for
  416.              files that begin with the  letter F and have a file  extension of
  417.              .C.
  418.  
  419.         /Wx  This option allows you to search for files that were created on a
  420.              specific day of the week. Replace the x with a digit in the range
  421.              of 0-6 where 0=Sunday, 1=Monday, 2=Tuesday, etc.
  422.  
  423.         /Tx  This option allows you to  find files that contain specific  text
  424.              strings.  Replace  the x with the text string  you wish to search
  425.              for.  For example, to  find all files that contain the  word TIME
  426.  
  427.  
  428.                           FileFinder Version 4.5 User Manual          Page-12-
  429.  
  430.              use the code the parameter as follows:
  431.              /Ttime
  432.  
  433.              If the word or phrase you wish to search for  has embedded spaces
  434.              you MUST ENCLOSE THE ENTIRE PARAMETER IN QUOTES.  For example, to
  435.              find all files that contain  the phrase NOW IS THE TIME  code the
  436.              parameter as follows:
  437.              "/Tnow is the time"
  438.  
  439.              PLEASE NOTE: THE /T OPTIONS CAN NOT BE USED TO SEARCH FOR TEXT
  440.              IN FILES CONTAINED WITHIN COMPRESSED FILES.
  441.  
  442.  
  443.                           FileFinder Version 4.5 User Manual          Page-13-
  444.  
  445.                                      FFF PROGRAM
  446.  
  447.         This  program will find files on your hard disk, and present them in a
  448.         scrollable list.
  449.  
  450.         Format is FFF [options] [[drives:] [filespec]] [options]
  451.  
  452.         Where options are:
  453.         /2   25 line mode display
  454.         /4   43 line mode display
  455.         /5   50 line mode display
  456.         /d   Search for dup files. (filename.ext only)
  457.         /D   Search for dup files. (filename.ext and file size)
  458.         /E   Extended Directory Search
  459.         /G   Greater or Equal to mm-dd-yy
  460.         /=   Equal to mm-dd-yy
  461.         /L   Less or Equal to mm-dd-yy
  462.         /I   also look inside archive files
  463.         /A   only look inside archive files
  464.              (THE ARCHIVE  FILES THAT  ARE SUPPORTED  ARE ZIP,ARC,ARJ,PAK,LZH,
  465.              and SQZ)
  466.         /Z[RHSA]
  467.              Show files with specified attributes
  468.         /SD  Single Directory search only (do not recurse)
  469.         /NN  No-Network drive search
  470.         /LN  Look for network drives
  471.         /@   Prompt for options.
  472.         /!   Exclude files that match specified pattern.
  473.         /w   Find files that were created or modified on a specific day of the
  474.              week.
  475.         /t   Find files that contain a specified text string.
  476.  
  477.         /I   This option tells FFF to also  look inside any archive files  for
  478.              the indicated files.   The archive files  that are supported  are
  479.              ZIP, ARC, ARJ, ZOO, PAK, LZH, and SQZ files.
  480.  
  481.         /A   This option tells  FFF to ONLY look inside  archive files for the
  482.              indicated files.
  483.  
  484.         /d   This option tells FFF to search and display duplicate files. Only
  485.              the filename.ext will be used to determine duplicates.
  486.  
  487.         /D   This  option is the same as the /d option except the filename.ext
  488.              and file size will be used to determine if a file is a dup.
  489.  
  490.         /E   To  increase the file search process  FFF normally only looks for
  491.              directories that  do not contain  a file  extension.  Using  this
  492.              option tells FFF to also look for directories that contain
  493.                  directory names with extensions.
  494.  
  495.         /G   This option  allows you to  limit the  file search to  files that
  496.              have a filedate Greater than or Equal to  the date specified. The
  497.              format is /Gmm-dd-yy.
  498.              I.E. /G01-01-90    or   /G1-1-90  will  list files  that  have  a
  499.         filedate greater than or equal to 1-1-90.
  500.              (Note this option may be combined with the /L option to specify a
  501.         date range)
  502.  
  503.         /L   This  option allows you  to limit the  file search to  files that
  504.  
  505.  
  506.                           FileFinder Version 4.5 User Manual          Page-14-
  507.  
  508.              have  a filedate Less  than or Equal  to the date  specified. The
  509.              format is /Lmm-dd-yy.
  510.              I.E.  /L01-01-90    or   /L1-1-90  will  list files  that  have a
  511.              filedate less than or equal to 1-1-90.
  512.              (Note this option may be combined with the /G option to specify a
  513.         date range)
  514.  
  515.         /=   This option  allows you  to limit the  file search to  files that
  516.              have a filedate Equal to the  date specified. The format is /=mm-
  517.              dd-yy.
  518.              I.E.  /=01-01-90   or   /=1-1-90  will  list  files that  have  a
  519.              filedate to 1-1-90.
  520.  
  521.         /SD  This  option informs FF2  to only  search the directory  that was
  522.              specified on the command line  and not to search any  directories
  523.              that exist under the specified directory.
  524.  
  525.  
  526.                           FileFinder Version 4.5 User Manual          Page-15-
  527.  
  528.         /Z[RHSA]
  529.              This  option allows  you to limit  the file search  to files that
  530.              have specific attributes.  For example,  specifying /ZA will list
  531.              files that have the archive attribute, /ZRH  will list files that
  532.              have the read-only attribute OR the hidden attribute set.
  533.              **PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS OPTION
  534.              IS IGNORED.**
  535.  
  536.         /NN  This option allows you to bypass the searching of Network drives.
  537.              If you configured  FF2 to search for  network drives you may  use
  538.              this option to temporarily bypass the network drive search.
  539.  
  540.         /LN  This option allow you to search  for files on Network drives.  If
  541.              you  configured FF2  to ignore  network drives  you may  use this
  542.              options to temporarily look for files on any networked drives.
  543.  
  544.         /!   This  option allows you  to exclude  files. Files that  match the
  545.              excluded file  pattern will not  be listed.   For example if  you
  546.              entered the following command:
  547.              FF2  *.c /!f*.c
  548.              This would list all the files with a .C file extension EXCEPT for
  549.              files that begin  with the letter F and have  a file extension of
  550.              .C.
  551.  
  552.         /Wx  This option allows you to search for files that were created on a
  553.              specific day of the week. Replace the x with a digit in the range
  554.              of 0-6 where 0=Sunday, 1=Monday, 2=Tuesday, etc.
  555.  
  556.         /Tx  This option allows you to  find files that contain specific  text
  557.              strings.   Replace the x with the  text string you wish to search
  558.              for.  For  example, to find all files that  contain the word TIME
  559.              use the code the parameter as follows:
  560.  
  561.              /Ttime
  562.  
  563.              If the word or phrase you  wish to search for has embedded spaces
  564.              you MUST ENCLOSE THE ENTIRE PARAMETER IN QUOTES.  For example, to
  565.              find  all files that contain the phrase  NOW IS THE TIME code the
  566.              parameter as follows:
  567.              "/Tnow is the time"
  568.  
  569.              PLEASE NOTE: THE /T OPTIONS CAN NOT BE USED TO SEARCH FOR TEXT
  570.              IN FILES CONTAINED WITHIN COMPRESSED FILES.
  571.  
  572.         /@   This  options instructs FFF  to prompt  the user for  the command
  573.              line  parameters. PLEASE NOTE NO  OTHER PARAMETERS ARE ALLOWED ON
  574.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  575.              option also  allows the user  to use the DOS  redirect feature to
  576.              feed FF2 it's parameters.
  577.  
  578.              For example:  FFF /@ < FFF.DAT
  579.  
  580.              This  instructs FFF to  read its  parameters from the  file names
  581.              FFF.DAT.
  582.  
  583.  
  584.                           FileFinder Version 4.5 User Manual          Page-16-
  585.  
  586.         The filespec's that are  specified on the  command line can include  a
  587.         disk and directory. If a  disk and or directory is specified  than the
  588.         search will be restricted  to the specified disk and directory and any
  589.         sub-directories under  the specified  directory.   Each  filespec  can
  590.         contain different starting disks and directories.
  591.  
  592.         When  specifying the  file  to search  for  FFF has  a  quick complete
  593.         algorithm.  If you do not include a period and  the file extension FFF
  594.         will expand  the  filespec using  the  wildcard  character ?  for  the
  595.         remainder of  the filespec.   For example if  you entered FFF  AB, FFF
  596.         will  expand the filespec to AB??????.???.   If you enter FFF C:\BAT\B
  597.         FFF will expand the filespec  to C:\BAT\B???????.???.  However if  you
  598.         enter FFF B.* , FFF will  not alter the filespec since you  included a
  599.         period in the filespec.
  600.  
  601.         FFF also has an expanded wild card search algorithm. If you include an
  602.         *  on both sides  of the  filename, FFF will  find all  files that
  603.         contain  the  characters  entered  between  the  *'s  anywhere  in the
  604.         filename. For example:
  605.  
  606.         FFF *inst*
  607.  
  608.         This will find all files that contain inst somewhere in the filename.
  609.              I.E  D:\ANY\PINST.BAT
  610.                   C:\ONE\PCINSTAL.BAT
  611.                   C:\TWO\INSTALL.COM
  612.  
  613.         To  find  files with  no  extension include  the  period  but no  file
  614.         extension. I.E.  FFF *me*.
  615.  
  616.         If no  disk or directory is  included with the filespec  than all hard
  617.         disks will be searched.
  618.  
  619.         FFF now has the capability to automatically identify all hard disks on
  620.         your  system.  You  can over-ride this  automatic detection by setting
  621.         the environment variable FF to the disk letter your wish the search to
  622.         be performed on.
  623.  
  624.         For example.  SET FF=CD tells FFF to search the C and D drives if  you
  625.         have not specified a disk in the filespec on the command line.
  626.  
  627.         FFF will display  all the files it found, up  to it's internal maximum
  628.         of 3000 files, on the screen in a scrollable list.  You can use the
  629.         cursor  keys, Pgup, Pgdn,  HOME, END, CTL-HOME,  and CTL-END to scroll
  630.         the list.  Pressing the ESC key will exit the program.
  631.  
  632.  
  633.                           FileFinder Version 4.5 User Manual          Page-17-
  634.  
  635.                                      FFF HOT KEYS
  636.  
  637.         ALT-X
  638.         ALT-Q
  639.         ESC  Any of these keys will immediately exit FFF.
  640.  
  641.         CURSOR-RIGHT
  642.         CURSOR-LEFT
  643.              Scroll screen right or left.
  644.  
  645.         HOME Pressed  once will take you to  top of screen. Pressed twice will
  646.         take you to top of list.
  647.  
  648.         END  Pressed  once will take  you to  bottom of screen.  Pressed twice
  649.              will take you to bottom of list.
  650.  
  651.         F1   will display the help panel.
  652.  
  653.         F9   This will  allow you to sort  the file list that  is displayed on
  654.              the screen.  The list can  be sorted by filename, file extension,
  655.              file date, or disk:\dir location.
  656.  
  657.         ENTER
  658.              Pressing the ENTER will do  one of three things depending  on how
  659.              the ENTER key was configured.
  660.  
  661.              1) The ENTER key will do nothing.
  662.  
  663.              2) The  ENTER key will exit  the FFF program and  will change the
  664.              default disk  and directory  to the one   that contains  the file
  665.              currently highlighted on the screen.
  666.  
  667.              3) The  ENTER key will  invoke the SHEZ program  on the currently
  668.              highlighted file.
  669.  
  670.         CTRL-ENTER
  671.  
  672.              The CTRL-ENTER key invokes the SMART LAUNCH feature  of FFF.  FFF
  673.              looks at the file extension of the currently highlighted file and
  674.              execute the program that is associated with  that extension.  The
  675.              associations are  defined during  the  configuration of  the  FFF
  676.              program.   Before the  program is  launched, FFF will  attempt to
  677.              swap  itself out  of memory  if the  memory swapping  feature was
  678.              selected during program configuration.
  679.              If no smart launch program has been defined FFF will than  launch
  680.              the default BROWSE program.
  681.  
  682.         G    Pressing the G key will exit the FFF program and  will change the
  683.              default  disk and directory  to the one   that  contains the file
  684.              currently highlighted on the screen.
  685.  
  686.              (THE ENTER KEY WILL ONLY FUNCTION IF  THE USER SPECIFICALLY TELLS
  687.              THE FFFCFG PROGRAM TO ACTIVATE THE ENTER KEY.)
  688.  
  689.         R    Pressing the R key allows you to run any program you wish against
  690.              the  currently highlighted file.   A window  will pop-up in which
  691.              you must  enter program  name  that you  wish  to execute.    The
  692.              program  can be a DOS internal program,  i.e. del, rename, or any
  693.              EXE, COM,  or BAT file. When you enter the program to execute you
  694.  
  695.  
  696.                           FileFinder Version 4.5 User Manual          Page-18-
  697.  
  698.              must  tell FFF  where to  place the  highlighted filename  in the
  699.              command by using the !  character as a place holder.   Before FFF
  700.              runs the command  the !  will be replaced  with  the  highlighted
  701.              filename.
  702.  
  703.         S    Pressing the S key will invoke my  Compressed file manager called
  704.              SHEZ. The Program file SHEZ.EXE must  be in the DOS path for this
  705.              options to function.
  706.  
  707.         E    Pressing the E key will execute the program or BAT file currently
  708.              highlighted on  the screen.  Before the  Program is  executed FFF
  709.              will prompt you for any command line parameters that you want  to
  710.              pass  to  the  program.  It will  then  change  to  the disk  and
  711.              directory  that the program  is contained in,  unload itself from
  712.              memory and execute the program.
  713.  
  714.         T    The T key will toggle the tagged status of the highlighted item.
  715.  
  716.         U    The U key will untag all tagged items.
  717.  
  718.         ALT-D     will delete the currently highlighted file.
  719.  
  720.         ALT-L     The ALT-L  key  will  invoke  the  browser  program  on  the
  721.                   highlighted  file.  The  BRZ.COM program must  be in the DOS
  722.                   path for this option to function.
  723.  
  724.         ALT-E     The  ALT-E key  will invoke  an editor  of your  choice. The
  725.                   default editor is QEdit  by Sammy Mitchell, however you  can
  726.                   change this default by using the FFFCFG program.
  727.  
  728.         ALT-C
  729.         ALT-O     The  ALT-O  or  ALT-C  keys  will  allow  you  to  copy  the
  730.                   highlighted file.   A window will  appear prompting you  for
  731.                   the destination drive and directory.
  732.  
  733.         ALT-W     The ALT-W key will invoke  a word processor of your  choice.
  734.                   The wordprocessor  program name must be set using the FFFCFG
  735.                   program before this options can be used.
  736.  
  737.         ALT-T     Write out the displayed file list to the file FFF.LST.
  738.              (Also see section titled: MODIFYING THE FFF FILE LISTING FORMAT)
  739.  
  740.         ALT-P     Print out the displayed file list to user specified device.
  741.              (Also see section titled: MODIFYING THE FFF PRINT FORMAT)
  742.  
  743.         ALT-I     Display a  windows containing configuration  and file  stats
  744.         information.
  745.  
  746.         ALT-S     Shell to DOS
  747.  
  748.         CTL-D     will delete all tagged files.
  749.  
  750.         CTL-C
  751.         CTL-O     The  CTL-O  or CTL-C  keys will  allow you  to copy  the all
  752.                   tagged  files.  A  window will appear  prompting you for the
  753.                   destination drive and directory.
  754.  
  755.         CTL-R     Pressing  the CTL-R key  allows you  to run any  program you
  756.                   wish  against all  tagged files.   A  window will  pop-up in
  757.  
  758.  
  759.                           FileFinder Version 4.5 User Manual          Page-19-
  760.  
  761.                   which you must enter  program name that you wish to execute.
  762.                   The program can be a DOS internal program, i.e. del, rename,
  763.                   or any EXE, COM, or BAT file.  When you enter the program to
  764.                   execute you must tell FFF where to place the tagged filename
  765.                   in the command by using  the ! character as a place  holder.
  766.                   Before FFF runs the command the ! will be replaced  with the
  767.                   filename.
  768.  
  769.         CTL-T     Write out a list of all tagged files to file FFF.LST.
  770.  
  771.         CTL-P     Print out a list of all tagged files to device STDPRN.
  772.  
  773.         CTL-G     Pressing the CTL-G keys will  allow you to run the  included
  774.                   SGREP  program against a  group of  tagged files.   (See the
  775.                   section titled SGREP PROGRAM for more information)  You will
  776.                   have  the option  of performing  a normal  text search  or a
  777.                   regular expression search against all tagged files.
  778.  
  779.         /    Pressing the forward slash key will activate the FFF menu system.
  780.              A menu bar will appear at the top of the screen.  Using the left,
  781.              right, up, and down cursor keys highlight  the menu item you wish
  782.              to activate then press the  ENTER key to perform the  highlighted
  783.              operations.  Pressing the ESC key will exit the menu system.
  784.  
  785.         CAPS-LOCK
  786.              When the CAPS-LOCK key is active,  a tagged file status line will
  787.              be displayed on the bottom of the screen.  Pressing the CAPS-LOCK
  788.              key again will remove this status line.
  789.  
  790.         ALT-F2
  791.              The ALT-F2 keys allows the user  to modify the format of the file
  792.              list that is written out when the ALT-T keys are pressed.
  793.  
  794.         ALT-F3
  795.         ALT-F4
  796.              The ALT-F3 and ALT-F4  keys allows the user  to modify the  print
  797.              format when  the ALT-P keys are  pressed.  The ALT-F3  key allows
  798.              you to edit print  line 1 format.  The ALT-F4 keys allows your to
  799.              edit the print line2 format.
  800.  
  801.         ALT-F5
  802.              The ALT-F5 keys  allows the use to change the  default print line
  803.              length.
  804.  
  805.  
  806.                           FileFinder Version 4.5 User Manual          Page-20-
  807.  
  808.                         MODIFYING THE FFF FILE LISTING FORMAT
  809.  
  810.         When writing out a file list using the ALT-T keys, FFF uses a template
  811.         that defines the format of the  file.  The template contains variables
  812.         that tells FFF what information  to include in the file listing.   The
  813.         following variables can be used when defining the template:
  814.  
  815.         VARIABLE  DESCRIPTION              LENGTH
  816.         $FF  =    filename.file-extension       12 characters
  817.         $FN  =    filename            variable
  818.         $FX  =    file-extension           variable
  819.         $N8  =    filename            8 characters
  820.         $X3  =    file-extension           3 characters
  821.         $DN  =    directory-name           variable
  822.         $DF  =    directory-name           80 characters
  823.         $CN  =    full-path-specification       variable
  824.         $SZ  =    file-size                8 characters
  825.         $DT  =    file-date           8 characters
  826.         $TI  =    file-time           8 characters
  827.         $AT  =    file-attributes               4 characters
  828.  
  829.         The default format when writing out a file listing is:
  830.         $SZ $DT $TI $AT $CN
  831.  
  832.         Using the ALT-F2 command the format of the listing file can be changed
  833.         while  FFF is currently  being executed.   When modifying the template
  834.         please be aware that anything entered on the  template line other than
  835.         a  variable name  will also  appear in  the file  listing file.   THIS
  836.         INCLUDED BLANK CHARACTERS.
  837.  
  838.         The  default may  also  be changed  by using  the  FFFCFG program  and
  839.         modifying the listing template when then appropriate prompt appears.
  840.  
  841.  
  842.                           FileFinder Version 4.5 User Manual          Page-21-
  843.  
  844.                             MODIFYING THE FFF PRINT FORMAT
  845.  
  846.         When printing out a file list using the ALT-P keys, FFF uses a
  847.         template that defines the format of the file.  The template contains
  848.         variables that tells FFF what information to include in the printer
  849.         listing.  The following variables can be used when defining the
  850.         template:
  851.  
  852.         VARIABLE  DESCRIPTION              LENGTH
  853.         $FF  =    filename.file-extension       12 characters
  854.         $FN  =    filename            variable
  855.         $FX  =    file-extension           variable
  856.         $N8  =    filename            8 characters
  857.         $X3  =    file-extension           3 characters
  858.         $DN  =    directory-name           variable
  859.         $DF  =    directory-name           80 characters
  860.         $CN  =    full-path-specification       variable
  861.         $SZ  =    file-size                8 characters
  862.         $DT  =    file-date           8 characters
  863.         $TI  =    file-time           8 characters
  864.         $AT  =    file-attributes               4 characters
  865.  
  866.         The default format when printing out a file listing is two lines per
  867.         file. Their format is as follows.
  868.         $CN
  869.         $SZ $DT $TI $AT
  870.  
  871.         Using the ALT-F3 and ALT-F4 commands the format of print line one and
  872.         print line two can be changed while FFF is currently being executed.
  873.         If you do not want two print lines produced per file set the second
  874.         print line template to all blanks via the ALT-F4 command or set the
  875.         second print line template to all blanks when using the FFFCFG program
  876.         to configure the FFF program. When modifying the template please be
  877.         aware that anything entered on the template line other than a variable
  878.         name will also appear in the file listing file.  THIS INCLUDED BLANK
  879.         CHARACTERS.
  880.  
  881.         The default may also be changed by using the FFFCFG program and
  882.         modifying the print line templates when then appropriate prompt
  883.         appears.
  884.  
  885.  
  886.                           FileFinder Version 4.5 User Manual          Page-22-
  887.  
  888.                                      FFD PROGRAM
  889.  
  890.         This  program will find directories on  your hard disk(s), and present
  891.         them in a scrollable list.
  892.  
  893.         Format is FFD [options] [[drives:] [filespec]] [options]
  894.  
  895.         Where options are:
  896.         /2   25 line mode display
  897.         /4   43 line mode display
  898.         /5   50 line mode display
  899.         /G   Greater or Equal to mm-dd-yy
  900.         /=   Equal to mm-dd-yy
  901.         /L   Less or Equal to mm-dd-yy
  902.         /Z[RHSA]
  903.              Show files with specified attributes
  904.         /LN  Look for network drives
  905.         /@   Prompt for options.
  906.         /!   Exclude directories that match specified pattern.
  907.  
  908.         /G   This option  allows you to  limit the file  search to files  that
  909.              have a filedate  Greater than or Equal to the date specified. The
  910.              format is /Gmm-dd-yy.
  911.              I.E.  /G01-01-90   or    /G1-1-90  will list  files  that  have a
  912.         filedate greater than or equal to 1-1-90.
  913.              (Note this option may be combined with the /L option to specify a
  914.         date range)
  915.  
  916.         /L   This option  allows you to  limit the  file search to  files that
  917.              have  a filedate Less  than or Equal  to the  date specified. The
  918.              format is /Lmm-dd-yy.
  919.              I.E. /L01-01-90    or   /L1-1-90  will  list files  that  have  a
  920.              filedate less than or equal to 1-1-90.
  921.              (Note this option may be combined with the /G option to specify a
  922.         date range)
  923.  
  924.         /=   This  option allows you  to limit the  file search to  files that
  925.              have a  filedate Equal to the date specified. The format is /=mm-
  926.              dd-yy.
  927.              I.E.  /=01-01-90   or    /=1-1-90 will  list  files  that have  a
  928.              filedate to 1-1-90.
  929.  
  930.         /Z[RHSA]
  931.              This option  allows you  to limit the  file search to  files that
  932.              have specific attributes.  For example, specifying  /ZA will list
  933.              files that have  the archive attribute, /ZRH will list files that
  934.              have the read-only attribute OR the hidden attribute set.
  935.              **PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS OPTION
  936.              IS IGNORED.**
  937.  
  938.         /LN  This option  allow you to search for files on Network drives.  If
  939.              you  configured FF2  to ignore  network drives  you may  use this
  940.              options to temporarily look for files on any networked drives.
  941.  
  942.         /!   This option  allows you to exclude  directories. Directories that
  943.              match the  excluded pattern will not  be listed.  For  example if
  944.              you entered the following command:
  945.              FF2  * /!f*
  946.              This would list all the dirs  EXCEPT for dirs that begin with the
  947.  
  948.  
  949.                           FileFinder Version 4.5 User Manual          Page-23-
  950.  
  951.              letter F..
  952.  
  953.         /@   This  options instructs FFD  to prompt  the user for  the command
  954.              line parameters. PLEASE  NOTE NO OTHER PARAMETERS ARE  ALLOWED ON
  955.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  956.              option  also allows the user  to use the  DOS redirect feature to
  957.              feed FF2 it's parameters.
  958.  
  959.              For example:  FFD /@ < FFD.DAT
  960.  
  961.              This  instructs FFD to  read its  parameters from the  file names
  962.         FFD.DAT.
  963.  
  964.  
  965.                           FileFinder Version 4.5 User Manual          Page-24-
  966.  
  967.                                      FFD HOT KEYS
  968.  
  969.         ALT-X
  970.         ALT-Q
  971.         ESC  Any of these keys will immediately exit FFF.
  972.  
  973.         CURSOR-RIGHT
  974.         CURSOR-LEFT
  975.              Scroll screen right or left.
  976.  
  977.         HOME Pressed  once will take you to  top of screen. Pressed twice will
  978.         take you to top of list.
  979.  
  980.         END  Pressed  once will take  you to  bottom of screen.  Pressed twice
  981.              will take you to bottom of list.
  982.  
  983.         F1   will display the help panel.
  984.  
  985.         F9   This will  allow you to sort  the file list that  is displayed on
  986.              the screen.  The list can  be sorted by filename, file extension,
  987.              file date, or disk:\dir location.
  988.  
  989.         ENTER
  990.              Pressing the  ENTER  key will  run the  FFF  program against  the
  991.         currently highlighted directory.
  992.  
  993.         G    Pressing the  G key will exit the FFD program and will change the
  994.              default disk and directory to the one currently highlighted.
  995.  
  996.         ALT-I     Display a windows containing FFF stats and information.
  997.  
  998.         ALT-S     Shell to DOS.
  999.  
  1000.         DEL  will delete all tagged files.
  1001.  
  1002.         ALT-T     Write out directory list to file FFD.LST
  1003.  
  1004.  
  1005.                           FileFinder Version 4.5 User Manual          Page-25-
  1006.  
  1007.                                  SMART LAUNCH FEATURE
  1008.  
  1009.         The SMART LAUNCH  feature of FFF allows FFF to  execute a user defined
  1010.         program based on the file extension of the currently highlighted file.
  1011.         The FFFCFG  program allows you to enter  three sets of file extensions
  1012.         and three associated programs to launch when the CTRL-ENTER is pressed
  1013.         in the FFF program.
  1014.         The FFFCFG program will display the following prompts:
  1015.  
  1016.         ENTER/EDIT FILE EXTENSION LIST 1:
  1017.         EXT->
  1018.  
  1019.         AT this prompt enter the  first list of file extensions that  you wish
  1020.         the FFF program to identify.  The list must include  the dot extension
  1021.         separator and there may NOT be and spaces in  the list.  If you wanted
  1022.         FFF to identify  the following file  extensions, C, H,  CPP, INC,  the
  1023.         list would be entered as follows:
  1024.         .C.H.CPP.INC
  1025.  
  1026.         ENTER/EDIT PROGRAM FOR EXTENSION LIST 1:
  1027.         PGM->
  1028.  
  1029.         At this  prompt enter the full path name of  the program that you want
  1030.         FFF to  launch if the  highlighted file has  a file extension  that is
  1031.         included in list number 1.
  1032.  
  1033.         i.e.  PGM->C:\UTILITY\EDIT.EXE !
  1034.  
  1035.         NOTE THE  ! CHARACTER.   THIS CHARACTER  INDICATES TO THE  FFF PROGRAM
  1036.         WHERE TO PLACE  THE FILENAME WHEN LAUNCHING THE PROGRAM.   Through the
  1037.         use of  this character the user can also place any needed command line
  1038.         switches in the PGM specification.
  1039.  
  1040.                             MEMORY SWAPPING OPTION IN FFF
  1041.         Beginning  with release  3.3  of the  FFF program,  a  memory swapping
  1042.         ability  has been added.  When invoking  the Editor, SHEZ, shelling to
  1043.         DOS, or invoking another program via the R or CTL-R functions, FFF can
  1044.         optionally swap  90% of  its code  to either XMS,  EMS memory  (3.0 or
  1045.         4.0), or to disk if XMS or  EMS memory is not available.  This  option
  1046.         is  OFF  by  default.   It  can  be  turned  on by  using  the  FFFCFG
  1047.         configuration  program.   Using  this option  allows you  to  run much
  1048.         larger programs from within FFF than  would be normally possible.  FFF
  1049.         first tries XMS memory than EMS memory.
  1050.  
  1051.                                  MONOCHROME MONITORS
  1052.  
  1053.         If you are using a  monochrome monitor and the screen does  not appear
  1054.         correct set the environment variable MONO to a Y.  I.E. SET MONO=Y.
  1055.  
  1056.                                   MISC. INFORMATION
  1057.  
  1058.         Both FF2 and FFF are both DesQview aware.
  1059.         Beginning with  version 3.4  both FF2  and FFF  will  now also  search
  1060.         directories that have hidden or system  attributes associated with the
  1061.  
  1062.  
  1063.                           FileFinder Version 4.5 User Manual          Page-26-
  1064.  
  1065.         directory.
  1066.  
  1067.  
  1068.                           FileFinder Version 4.5 User Manual          Page-27-
  1069.  
  1070.                                   THE SGREP PROGRAM
  1071.  
  1072.         The SGREP program, supplied with SHEZ, is used by SHEZ when the ALT-G
  1073.         key is pressed, to scan member(s) of a compressed file for words or
  1074.         phrases.  It is included in the SHEZ package for those user's that do
  1075.         not have the FGREP program written by Chris Dunford.  While the SGREP
  1076.         program performs the same function, it is not as fast or as powerful
  1077.         as Chris Dunford's FGREP program.  When the ALT-G keys are pressed,
  1078.         SHEZ first tries to locate the SGREP.COM program,  if it can not be
  1079.         found SHEZ will than try to locate the FGREP.COM program.  Which ever
  1080.         program is found will be the one SHEZ users to scan for text.
  1081.  
  1082.         The SGREP command line format uses a subset of the FGREP program to
  1083.         maintain compatibility with FGREP.  SGREP does allow the user to
  1084.         specify two target strings in the search argument.  These two target
  1085.         strings are connected with an and, &, or or, '|' separator.  Thus
  1086.         allowing the user to search for two different strings, or two strings
  1087.         or words contained on the same line.  When the specific string is
  1088.         found, the line in the file that contains the string is written to the
  1089.         stdout DOS device, which is normally the display.  The output may be
  1090.         redirected to a file or a printer using the normal DOS redirection
  1091.         symbols.  The format of the SGREP command line is as follows:
  1092.  
  1093.         SGREP [options] "target(s)" {file(s)...|@file}
  1094.  
  1095.         Where options are:
  1096.  
  1097.              -f   display **FILE-NAME for finds only
  1098.              -l   line numbers
  1099.              -c   case sensitive search
  1100.              -x   no logo
  1101.              -e   return errorlevel only
  1102.              -p   pause when screen is full
  1103.              -v   verbose display output
  1104.              -r   perform a regular expression search
  1105.  
  1106.         @file indicates an ascii file containing a list of file to process.
  1107.         This list MUST include the complete file specification.  I.E. The
  1108.         disk, directory, filename, and file extension.
  1109.  
  1110.         The target string(s) must be enclosed in quotes and special characters
  1111.         can be specified as indicated below.
  1112.  
  1113.         Hex byte sequences can be used to search for special non-displayable
  1114.         characters.  They are specified using a pair of hexadecimal bytes
  1115.         preceded by a dollar sign,$.
  1116.  
  1117.         EXAMPLES: $23       include is the string #include
  1118.                   $252.50   is the string %2.50
  1119.                   $23$24$25 is the string #$%
  1120.  
  1121.         Two targets may be specified using the & and | characters to search
  1122.         for two targets.  If the & is used the lines must contain
  1123.         both targets.  If the | is used the lines must contain one of the
  1124.         targets.
  1125.  
  1126.         Example:  "save|main"    line must have save or main to be listed.
  1127.                   "save&main"    line must have save and main to be listed.
  1128.  
  1129.  
  1130.                           FileFinder Version 4.5 User Manual          Page-28-
  1131.  
  1132.         The format of the SGREP command line is presented here for
  1133.         documentation purposes only since FFF automatically invokes SGREP
  1134.         itself using a predefined set of options.  SGREP may be run from the
  1135.         DOS command prompt, or when using the CTRL-G command option of FFF.
  1136.  
  1137.  
  1138.                           FileFinder Version 4.5 User Manual          Page-29-
  1139.  
  1140.                                  REGULAR EXPRESSIONS
  1141.  
  1142.         The regular_expression defines the pattern to search for.  Upper- and
  1143.         lower-case are always ignored.  Blank lines never match.  The
  1144.         expression should be quoted to prevent file-name translation.
  1145.  
  1146.         x     An ordinary character (not mentioned below) matches that
  1147.              character.
  1148.         "\"  The backslash quotes any character.  "\$" matches a dollar-sign.
  1149.         "^"  A circumflex at the beginning of an expression matches the
  1150.              beginning of a line.
  1151.         "$"  A dollar-sign at the end of an expression matches the end of a
  1152.              line.
  1153.         "."  A period matches any character except "new-line".
  1154.         "*"  An expression followed by an asterisk matches zero or more
  1155.              occurrences of that expression: "fo*" matches "f", "fo"  "foo",
  1156.              etc.
  1157.         "+"  An expression followed by a plus sign matches one or more
  1158.              occurrences of that expression: "fo+" matches "fo", etc.
  1159.         "-"  An expression followed by a minus sign optionally matches the
  1160.              expression.
  1161.  
  1162.         "[]" A string enclosed in square brackets matches any character in
  1163.              that string, but no others.  If the first character in the string
  1164.              is a circumflex, the expression matches any character except
  1165.              "new-line" and the characters in the string.  For  example,
  1166.              "[xyz]" matches "xx" and "zyx", while "[^xyz]"      matches "abc"
  1167.              but not "axb".  A range of characters may be specified by two
  1168.              characters separated by "-".  Note that, [a-z] matches
  1169.              alphabetic, while [z-a] never matches.
  1170.  
  1171.  
  1172.                           FileFinder Version 4.5 User Manual          Page-30-
  1173.  
  1174.                                    REVISION HISTORY
  1175.  
  1176.         v4.5 12/27/93 FFF will use EMS automatically if available  for storing
  1177.              directory information.
  1178.              Added /T command  line parameter to  FF2 and FFF program  to find
  1179.              files that contain specified text strings.
  1180.              Added /W command  line parameter to FF2  and FFF program  to find
  1181.              files created or modified on a specific day of the week.
  1182.              FFF, FF2 and FFD will now automatically bypass CD-ROM drives.
  1183.              Corrected screen scrolling problem in FF2.
  1184.              FFF, FF2, and FFD now  use a common external configuration  files
  1185.              that is created and maintained by the FFFCFG program.
  1186.              When  performing  a  search  on tagged  files  in  FFF  a regular
  1187.              expression search may now optionally be performed.
  1188.              The file viewing program BRZ is now included in the FFF package.
  1189.  
  1190.         v4.4 09/20/93 Increased file limit in FFF to 15,000 files.
  1191.              Added ability to print to a file or to LPT1-9.
  1192.              Gave user the ability to modify the format of a saved file list.
  1193.              Gave  user  the ability  to  modify the  format of  a  print file
  1194.              listing.
  1195.              Fixed problem with FFF not finding the last duplicate file.
  1196.              The FFD  program will now show the root directory of all included
  1197.              search drives.
  1198.              When writing  a file list  FFF will  now prompt to  over-write or
  1199.              append the file if the FFF.LST file already exists.
  1200.              Added the ALT-T command to the FFD program.
  1201.              Added the FFFHLP.COM program to reduce the memory requirements of
  1202.              the FFF program.
  1203.  
  1204.         v4.3 04/13/93 Added  ability to  exclude  user specified  drives  from
  1205.              being searched.
  1206.              Made correction to date/time sort.
  1207.              Added CTRL right and left cursor for faster screen scrolling.
  1208.              Made swapping type configurable.
  1209.              Fixed ALT-T command.
  1210.              Increased search speed by 15-20%.
  1211.              Increased sort speed by 20%.
  1212.              When checking  for duplicate  files  user can  optionally  search
  1213.              inside compressed files for dups.
  1214.              Added drop down menu to the FFF program.
  1215.              Added more configuable item to the FFF program.
  1216.              Added  new program FFD  that will  search for  directory spanning
  1217.              drives.
  1218.  
  1219.         v4.2 03/14/93  Maximum number of  files that  FFF can handle  has been
  1220.              increased to 10,000.
  1221.              Added command line option /! to exclude file during search.
  1222.              Added command line option /= to search for file equal to a date.
  1223.              Enhanced the HOME and END keys in FFF.
  1224.              Corrected sorting  routine  when  sorting  by  filename  or  file
  1225.              extension.
  1226.              When sorting by extension, files with equal extensions will  also
  1227.              be sorted by filename.
  1228.              Added  support to  search for  files inside  SQZ type  compressed
  1229.              files.
  1230.  
  1231.         v4.1 11/9/92  Fixed the FFF  program to correctly  accept command line
  1232.  
  1233.  
  1234.                           FileFinder Version 4.5 User Manual          Page-31-
  1235.  
  1236.              options that  are  entered in  when  using  the /@  command  line
  1237.              switch.
  1238.              Added the ability to configure the function of the ENTER key.
  1239.              Added a smart launch feature to the FFF program that is activated
  1240.              via the CTRL-ENTER key combination.
  1241.  
  1242.         v3.8 4/1/92  Added CAPS-LOCK  command in  FFF to  display tagged  file
  1243.              status.
  1244.              Increased speed of locating and identifying all hard drives.
  1245.              Added SGREP program to search for text within tagged files.
  1246.              Added ability to swap FFF program to XMS or EMS memory.
  1247.              Added scroll bars to FFF display.
  1248.              Added ALT-C command to copy single files.
  1249.              Added CTL-C command to copy tagged files.
  1250.              Added CTL-G  command  to run  SGREP program  against  a group  of
  1251.              tagged files.
  1252.  
  1253.         v3.7 7/19/91  Corrected FFF  processing when  searching for  all files
  1254.              when using the /i option.
  1255.              Changed  the  FFFCFG  program  to  retain  previously  configured
  1256.              colors.
  1257.              Added the ability to perform a fuzzy search.
  1258.              Added a configurable  option to turn the file  over-write warning
  1259.              message off when copying tagged files.
  1260.  
  1261.         V3.6 5/6/91 - Corrected floating tags.
  1262.              Added ALT-I to display config. and file stats.
  1263.              Implemented new sort routine to speed up file sorting.
  1264.              Added ALT-T, CTL-T commands to write out a file list.
  1265.              Added ALT-P, CTL-P commands to print out a file list.
  1266.              Added ability to configure FFF's colors.
  1267.              Added ALT-X, and ALT-Q to exit FFF.
  1268.              Added the ability to activate or deactivate the ENTER key.
  1269.              Added the ability to configure FFF to handle up to 9000 files and
  1270.              300 unique directory names.
  1271.              When  invoking the  browse  program  via  the ALT-L  command,  if
  1272.              swapping  is enabled FFF  will swap  itself out of  memory before
  1273.              invoking the browse program.
  1274.  
  1275.  
  1276.                           FileFinder Version 4.5 User Manual          Page-32-
  1277.  
  1278.                                         INDEX
  1279.  
  1280.         CONFIGURING THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . . . .  5
  1281.  
  1282.         FF2 Command line options
  1283.  
  1284.              /! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1285.  
  1286.              /= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1287.  
  1288.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1289.  
  1290.              /1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1291.  
  1292.              /A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1293.  
  1294.              /B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1295.  
  1296.              /C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1297.  
  1298.              /E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1299.  
  1300.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1301.  
  1302.              /I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1303.  
  1304.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1305.  
  1306.              /P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1307.  
  1308.              /Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1309.  
  1310.              /R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1311.  
  1312.              /S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1313.  
  1314.              /SD  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1315.  
  1316.         FFD Command line options
  1317.  
  1318.              /! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1319.  
  1320.              /= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1321.  
  1322.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1323.  
  1324.              /2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1325.  
  1326.              /4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1327.  
  1328.              /5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1329.  
  1330.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1331.  
  1332.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1333.  
  1334.              /LN  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1335.  
  1336.              /Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1337.  
  1338.         FFD HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  1339.  
  1340.         FFD PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1341.  
  1342.         FFF Command line options
  1343.  
  1344.              /! . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1345.  
  1346.              /= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1347.  
  1348.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1349.  
  1350.              /2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1351.  
  1352.              /4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1353.  
  1354.              /5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1355.  
  1356.              /A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1357.  
  1358.              /d . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1359.  
  1360.              /E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1361.  
  1362.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1363.  
  1364.              /I . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1365.  
  1366.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1367.  
  1368.              /SD  . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1369.  
  1370.              /Z[RHSA] . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1371.  
  1372.         FFF HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1373.  
  1374.         FFF PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 22
  1375.  
  1376.         MEMORY SWAPPING OPTION IN FFF . . . . . . . . . . . . . . . . . . . 25
  1377.  
  1378.         MEMORY USAGE IN THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . .  6
  1379.  
  1380.         MODIFYING THE FFF FILE LISTING FORMAT . . . . . . . . . . . . . . . 20
  1381.  
  1382.         MODIFYING THE FFF PRINT FORMAT  . . . . . . . . . . . . . . . . . . 21
  1383.  
  1384.         MONOCHROME MONITORS . . . . . . . . . . . . . . . . . . . . . . . . 25
  1385.  
  1386.         PERFORMING A FUZZY SEARCH . . . . . . . . . . . . . . . . . . . . .  4
  1387.  
  1388.         QUICK START . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  1389.  
  1390.         REGULAR EXPRESSIONS . . . . . . . . . . . . . . . . . . . . . . . . 29
  1391.  
  1392.  
  1393.                           FileFinder Version 4.5 User Manual          Page-33-
  1394.  
  1395.         REVISION HISTORY  . . . . . . . . . . . . . . . . . . . . . . . . . 30
  1396.  
  1397.         SMART LAUNCH FEATURE  . . . . . . . . . . . . . . . . . . . . . . . 25
  1398.  
  1399.