home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / FFF33.ZIP / FFF.DOC < prev    next >
Text File  |  1990-10-02  |  20KB  |  461 lines
  1.                        File Finder Pack
  2.                           Version 3.3
  3.                            10-02-90
  4.                               by
  5.                            Jim Derr
  6.  
  7.                            Member of
  8.                 Association of Shareware Professionals
  9.                        CSERVE ID 76266,2634
  10.  
  11.  
  12.     Please note this is a shareware product.  If you find these utilities
  13.     useful please register and keep shareware alive.  Only registered users
  14.     will be supported.  The fee is small and not unreasonable.
  15.  
  16.     QUICK START
  17.  
  18.     FF2 and FFF use the same format for the command line option.  All
  19.     command line parameters MUST be seperated by blanks and all options
  20.     MUST begin with a forward slash /.  The options may appear anywhere
  21.     on the command line.  The format of the command line for both
  22.     programs is:
  23.  
  24.     FFx [options]  [[drives:] [filespec]] [options]
  25.  
  26.     If the drives parameter is omitted the programs will search all hard
  27.     drives that can be identified.  If the drives parameter is included
  28.     then only the drives specified will be searched. (PLEASE NOTE THE
  29.     COLON MUST BE ENTERED AFTER THE DRIVE LETTERS).
  30.  
  31.     If the colon is entered without any drive letter preceeding it then
  32.     FFF and FF2 will only search for files on the current default disk
  33.     drive.
  34.  
  35.     For example:
  36.  
  37.     FFF : *.bat
  38.  
  39.     This will search for all files on the current default drive that
  40.     have a file extension of bat.
  41.  
  42.     Mulitple filespecs may be entered along with multiple drives.  For
  43.     example.
  44.  
  45.     FF2  *.BAK CD: \UTILITY\*.COM  DE: \TEMP\*.*  C:\JIM\*.*
  46.  
  47.     This example will 1)  Find all files that have a file extension of
  48.                           .BAK that resides on any identifiable hard
  49.                           drive.
  50.  
  51.                       2)  Find all files that have a file extension of
  52.                           .COM in the UTILITY directory or any
  53.                           sub-directory of the UTILITY directory ONLY ON
  54.                           HARD DRIVES C AND D.
  55.  
  56.                       3)  Find all files that reside in the TEMP
  57.                           directory or any sub-directory of the TEMP
  58.                           directory ONLY ON HARD DRIVES D AND E.
  59.  
  60.                       4)  Find all files that reside in the JIM
  61.                           directory or any sub-directory of the JIM
  62.                           directory ONLY ON THE C DRIVE.
  63.  
  64.     Any options that appear on the command line are active for all
  65.     search operations.
  66.  
  67.  
  68.  
  69.  
  70.                      FF2         FileFinder2
  71.     ----------------------------------------------------------------------
  72.     This program will find files on your hard disk.  It as fashioned after
  73.     the whereis program but has more features.
  74.  
  75.     Format is FF2 [options] [[drives:] [filespec]] [options]
  76.     Where options are:
  77.       /C    comma delimited listing
  78.       /R    raw listing - full path name only
  79.       /S    short listing - filename.ext only
  80.       /B    list in bat file format
  81.       /P    pause when screen is full
  82.       /Q    quite mode
  83.       /I    also look inside archive files
  84.       /A    only look inside archive files
  85.       /E    Extended Directory Search
  86.       /G    Greater or Equal to mm-dd-yy
  87.       /L    Less or Equal to mm-dd-yy
  88.       /SD   Single Directory search only (do not recurse)
  89.       /1    stop after finding one file
  90.             errorlevel 1 returned if no files found
  91.             errorlevel 0 returned if files are found
  92.       /Z[RHSA] Show files with specified attributes
  93.       /X"cmd" execute a cmd against all files found
  94.  
  95.     The filespec's that are specified on the command line can include a disk
  96.     and directory. If a disk and or directory is specified than the search
  97.     will be restricted to the specified disk and directory and any
  98.     sub-directories under the specified directory.  Each filespec can
  99.     contain different starting disks and directories.
  100.  
  101.     When specifing the file to search for FF2 has a quick complete
  102.     algorithm.  If you do not include a period in the file extension
  103.     FF2 will expand the filespec using the wildcard character ? for the
  104.     remainder of the filespec.  For example if you entered FF2 AB, FF2
  105.     will expand the filespec to AB??????.???.  If you enter FF2 C:\BAT\B
  106.     FF2 will expand the filespec to C:\BAT\B???????.???.  However if you
  107.     enter FF2 B.* , FF2 will not alter the filespec since you included a
  108.     period in the filespec.
  109.  
  110.     FF2 also has an expanded wild card search algorithm. If you include
  111.     an * on both sides of the filename, FF2 will find all files that
  112.     contain the characters entered between the *'s anywhere in the filename.
  113.     For example:
  114.  
  115.         FF2 *inst*
  116.  
  117.             This will find all files that contain inst somewhere in the
  118.             filename.  I.E.  D:\ANY\PINST.BAT
  119.                              C:\ONE\PCINSTAL.BAT
  120.                              C:\TWO\INSTALL.COM
  121.  
  122.         To find files with no extension include the period but no
  123.         file extension. I.E.  FF2 *me*.
  124.  
  125.  
  126.     If no disk or directory is included with the filespec than all hard
  127.     disks will be searched.
  128.  
  129.     FF2 now has the capability to automatically identify all hard disks
  130.     on your system.  You can over-ride this automatic detection by
  131.     setting the environment variable FF to the disk letter your wish the
  132.     search to be performed on.
  133.  
  134.     For example.  SET FF=CD tells FF2 to search the C and D drives if you
  135.     have not specified a disk in the filespec on the command line.
  136.  
  137.     All output from FF2 can be redirected or piped by using the DOS redirect
  138.     and pipe characters.
  139.  
  140.     The default output produced by FF2 file-size, file-date, file-time,
  141.     disk:\directory\filename.fileext. This can be changed by using the
  142.     following command line options:
  143.  
  144.     /C      Produces a comma delimited listing, this listing can be
  145.             imported into most spreadsheet and database programs.
  146.  
  147.     /R      Produces a raw listing containing disk:\directory\fn.ext only.
  148.  
  149.     /S      Produces a short listing containg filename.ext only.
  150.  
  151.     /B      Produces a listing that can be used as a bat file. The output
  152.             is as follows:
  153.             %1 filename.ext %2 %3 %4 %5 %6 %7 %8 %9
  154.  
  155.     /P      Will case a pause when the screen is full.
  156.  
  157.     /Q      Quite mode no output produced but results can be tested by using
  158.             the if errorlevel command in a .bat file.
  159.  
  160.     /I      This option tells FF2 to also look inside any archive files
  161.             for the indicated files.  The archive files that are supported
  162.             are ZIP, ARC, and LZH files.
  163.  
  164.     /A      This option tells FF2 to ONLY look inside archive files for
  165.             the indicated files.
  166.  
  167.     /1      This option tells FF2 to stop looking for files after it
  168.             finds the first file that matches the specified pattern.
  169.  
  170.     /E      To increase the file search process FF2 normally only looks
  171.             for directories that do not contain a file extension.  Using
  172.             this option tells FF2 to also look for directories that contain
  173.             directory names with extensions.
  174.  
  175.     /G      This option allows you to limit the file search to files that
  176.             have a filedate Greater than or Equal to the date specified.
  177.             The format is /Gmm-dd-yy.
  178.             I.E. /G01-01-90  or  /G1-1-90 will list files that have a
  179.                  filedate greater than or equal to 1-1-90.
  180.             (Note this option may be combined with the /L option to
  181.              specify a date range)
  182.  
  183.     /L      This option allows you to limit the file search to files that
  184.             have a filedate Less than or Equal to the date specified.
  185.             The format is /Lmm-dd-yy.
  186.             I.E. /L01-01-90  or  /L1-1-90 will list files that have a
  187.                  filedate less than or equal to 1-1-90.
  188.             (Note this option may be combined with the /G option to
  189.              specify a date range)
  190.  
  191.     /Z[RHSA]
  192.             This option allows you to limit the file search to files
  193.             that have specific attributes.  For example, specifying
  194.             /ZA will list files that have the archive attribute,
  195.             /ZRH will list files that have the read-only attribute OR
  196.                  the hidden attribute set.
  197.             **********************************************************
  198.             *PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS*
  199.             *OPTIONS IS IGNORED.                                     *
  200.             **********************************************************
  201.  
  202.     /SD     This option informs FF2 to only search the directory that was
  203.             specified on the command line and not to search any directories
  204.             that exist under the specified directory.
  205.  
  206.  
  207.     /X"cmd" This options allows you to tell FF2 to execute a specified
  208.             against all files that are found.
  209.             For Example: /X"del &" will execute the delete command against
  210.             all file that were found.  The command can be any DOS command
  211.             or another program.  FF2 will insert the disk:\dir\fn.fext
  212.             of the found file into the command where you place the &
  213.             character.
  214.  
  215.             For example if you specify the following:
  216.  
  217.             /X"grep any & -s"
  218.  
  219.             and FF2 finds the file c:\data\any.doc it will execute the
  220.             following command:
  221.  
  222.             grep any c:\data\any.doc -s
  223.  
  224.             If you do not put the & in then FF2 will insert the found
  225.             filespec at the first blank in the command you specify, or at
  226.             the end of the command if no blanks exist.
  227.  
  228.  
  229.     Changing the default configuration of FF2.COM.
  230.     ----------------------------------------------------------------------
  231.     To alter the default configuration of FF2.COM Enter the following
  232.     at the C>: prompt:
  233.  
  234.         FF2 /cfg
  235.  
  236.     The program will then present you with a description of its current
  237.     default setting and will prompt you for the setting that can be changed.
  238.     FF2 will then update it's own FF2.COM program with the new default
  239.     settings.
  240.  
  241.  
  242.                      FFF         Fullscreen FileFinder
  243.     ----------------------------------------------------------------------
  244.     This program will find files on your hard disk, and present them in
  245.     a scrollable list.
  246.  
  247.     Format is FFF [options] [[drives:] [filespec]] [options]
  248.     Where options are:
  249.       /2    25 line mode display
  250.       /4    43 line mode display
  251.       /5    50 line mode display
  252.       /d    Search for dup files. (filename.ext only)
  253.       /D    Search for dup files. (filename.ext and file size)
  254.       /E    Extended Directory Search
  255.       /G    Greater or Equal to mm-dd-yy
  256.       /L    Less or Equal to mm-dd-yy
  257.       /I    also look inside archive files
  258.       /A    only look inside archive files
  259.             (THE ARCHIVE FILES THAT ARE SUPPORTED ARE ZIP,ARC, AND LZH)
  260.       /Z[RHSA] Show files with specified attributes
  261.       /SD   Single Directory search only (do not recurse)
  262.  
  263.  
  264.  
  265.     /I      This option tells FFF to also look inside any archive files
  266.             for the indicated files.  The archive files that are supported
  267.             are ZIP, ARC, and LZH files.
  268.  
  269.     /A      This option tells FFF to ONLY look inside archive files for
  270.             the indicated files.
  271.  
  272.     /d      This option tells FFF to search and display duplicate files.
  273.             Only the filename.ext will be used to determine duplicates.
  274.  
  275.     /D      This option is the same as the /d option except the filename.ext
  276.             and file size will be used to determine if a file is a dup.
  277.  
  278.     /E      To increase the file search process FFF normally only looks
  279.             for directories that do not contain a file extension.  Using
  280.             this option tells FFF to also look for directories that contain
  281.             directory names with extensions.
  282.  
  283.     /G      This option allows you to limit the file search to files that
  284.             have a filedate Greater than or Equal to the date specified.
  285.             The format is /Gmm-dd-yy.
  286.             I.E. /G01-01-90  or  /G1-1-90 will list files that have a
  287.                  filedate greater than or equal to 1-1-90.
  288.             (Note this option may be combined with the /L option to
  289.              specify a date range)
  290.  
  291.     /L      This option allows you to limit the file search to files that
  292.             have a filedate Less than or Equal to the date specified.
  293.             The format is /Lmm-dd-yy.
  294.             I.E. /L01-01-90  or  /L1-1-90 will list files that have a
  295.                  filedate less than or equal to 1-1-90.
  296.             (Note this option may be combined with the /G option to
  297.              specify a date range)
  298.  
  299.     /SD     This option informs FF2 to only search the directory that was
  300.             specified on the command line and not to search any directories
  301.             that exist under the specified directory.
  302.  
  303.     /Z[RHSA]
  304.             This option allows you to limit the file search to files
  305.             that have specific attributes.  For example, specifying
  306.             /ZA will list files that have the archive attribute,
  307.             /ZRH will list files that have the read-only attribute OR
  308.                  the hidden attribute set.
  309.             **********************************************************
  310.             *PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS*
  311.             *OPTIONS IS IGNORED.                                     *
  312.             **********************************************************
  313.  
  314.  
  315.     The filespec's that are specified on the command line can include a disk
  316.     and directory. If a disk and or directory is specified than the search
  317.     will be restricted to the specified disk and directory and any
  318.     sub-directories under the specified directory.  Each filespec can
  319.     contain different starting disks and directories.
  320.  
  321.     When specifing the file to search for FFF has a quick complete
  322.     algorithm.  If you do not include a period and the file extension
  323.     FFF will expand the filespec using the wildcard character ? for the
  324.     remainder of the filespec.  For example if you entered FFF AB, FFF
  325.     will expand the filespec to AB??????.???.  If you enter FFF C:\BAT\B
  326.     FFF will expand the filespec to C:\BAT\B???????.???.  However if you
  327.     enter FFF B.* , FFF will not alter the filespec since you included a
  328.     period in the filespec.
  329.  
  330.     FFF also has an expanded wild card search algorithm. If you include
  331.     an * on both sides of the filename, FFF will find all files that
  332.     contain the characters entered between the *'s anywhere in the filename.
  333.     For example:
  334.  
  335.         FFF *inst*
  336.  
  337.             This will find all files that contain inst somewhere in the
  338.             filename.  I.E.  D:\ANY\PINST.BAT
  339.                              C:\ONE\PCINSTAL.BAT
  340.                              C:\TWO\INSTALL.COM
  341.  
  342.         To find files with no extension include the period but no
  343.         file extension. I.E.  FFF *me*.
  344.  
  345.  
  346.     If no disk or directory is included with the filespec than all hard
  347.     disks will be searched.
  348.  
  349.     FFF now has the capability to automatically identify all hard disks
  350.     on your system.  You can over-ride this automatic detection by
  351.     setting the environment variable FF to the disk letter your wish the
  352.     search to be performed on.
  353.  
  354.     For example.  SET FF=CD tells FFF to search the C and D drives if you
  355.     have not specified a disk in the filespec on the command line.
  356.  
  357.  
  358.     FFF will display all the files it found, up to it's internal maximum
  359.     of 3000 files, on the screen in a scrollable list.  You can use the
  360.     cursor keys, Pgup, Pgdn, HOME, END, CTL-HOME, and CTL-END to scroll
  361.     the list.  Pressing the ESC key will exit the program.
  362.  
  363.  
  364.                             HOT KEYS
  365.     F1
  366.     F1 will display the help panel.
  367.  
  368.     E
  369.     Pressing the E key will change the default disk and directory to
  370.     the one that contains the file currently highlited on the screen.
  371.  
  372.     R
  373.     Pressing the R key allows you to run any program you wish against the
  374.     currently highlited file.  A window will pop-up in which you must enter
  375.     program name that you wish to execute.  The program can be a DOS
  376.     internal program, i.e. del, rename, or any EXE, COM, or BAT file.
  377.     When you enter the program to execute you must tell FFF where to place
  378.     the highlighted filename in the command by using the ! character as a
  379.     place holder.  Before FFF runs the command the ! will be replaced with
  380.     the highlighted filename.
  381.  
  382.     S
  383.     Pressing the S key will invoke my Compressed file manager called SHEZ.
  384.     The Program file SHEZ.EXE must be in the DOS path for this options to
  385.     function.
  386.  
  387.     G or ENTER key
  388.     Pressing the G or ENTER key will execute the program or BAT file currently
  389.     highlited on the screen. Before the Progam is executed FFF will
  390.     prompt you for any command line parameters that you want to pass to
  391.     the program. It will then change to the disk and directory that the
  392.     program is contained in, unload itself from memory and execute the
  393.     program.
  394.  
  395.     T
  396.     The T key will toggle the tagged status of the highlighted item.
  397.  
  398.     U
  399.     The U key will untag all tagged items.
  400.  
  401.     ALT-D
  402.     ALT-D will delete the currently highlighted file.
  403.  
  404.     ALT-L
  405.     The ALT-L key will invoke Vern Buerg's List program on the highlighted
  406.     file.  The list.com program must be in the DOS path for this option to
  407.     function.
  408.  
  409.     ALT-E
  410.     The ALT-E key will invoke Sammy Mitchell's Qedit program on the
  411.     highlighted file.  The Q.EXE program must be in the DOS path for this
  412.     option to function.
  413.  
  414.     ALT-O
  415.     The ALT-O key will allow you to copy the highlighted file.  A window
  416.     will appear prompting you for the destination drive and directory.
  417.  
  418.     CTL-D
  419.     CTL-D will delete all tagged files.
  420.  
  421.     CTL-O
  422.     The CTL-O key will allow you to copy the all tagged files.  A window
  423.     will appear prompting you for the destination drive and directory.
  424.  
  425.     CTL-R
  426.     Pressing the CTL-R key allows you to run any program you wish against all
  427.     tagged files.  A window will pop-up in which you must enter
  428.     program name that you wish to execute.  The program can be a DOS
  429.     internal program, i.e. del, rename, or any EXE, COM, or BAT file.
  430.     When you enter the program to execute you must tell FFF where to place
  431.     the tagged filename in the command by using the ! character as a
  432.     place holder.  Before FFF runs the command the ! will be replaced with
  433.     the filename.
  434.  
  435.     CHANGING THE DEFAULT CONFIGURATION OF FFF.EXE.
  436.     ----------------------------------------------------------------------
  437.     To alter the default configuration of FFF.EXE Execute the FFFCFG
  438.     program from the C>: prompt.
  439.  
  440.     To alter the default configuration setting in the FFF.EXE program
  441.     just follow the prompts that appear on the screen.
  442.  
  443.  
  444.     MEMORY SWAPPING OPTION IN FFF
  445.     ----------------------------------------------------------------------
  446.     Beginning with release 3.3 of the FFF program, a memory swapping ability
  447.     has been added.  When invoking the Editor, SHEZ, shelling to DOS, or
  448.     invoking another program via the R or CTL-R functions, FFF can optionally
  449.     swap 90% of its code to either EMS memory (3.0 or 4.0), or to disk if EMS
  450.     memory is not available.  This option is OFF by default.  It can be turned
  451.     on by using the FFFCFG configuration program.  Using this option allows
  452.     you to run much larger programs from within FFF than would be normally
  453.     possible.
  454.  
  455.  
  456.  
  457.                              MONOCHROME MONITORS
  458.  
  459.     If you are using a monochrome monitor and the screen does not appear
  460.     correct set the environment variable MONO to a Y.  I.E. SET MONO=Y.
  461.