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