home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / FFG153.ZIP / FFG.DOC < prev    next >
Text File  |  1993-08-04  |  56KB  |  1,530 lines
  1.  
  2.                              File Finder/Grouper (FFG)
  3.                                    Version 1.53
  4.  
  5.                                  Shareware Manual
  6.  
  7.                           Copyright 1992-1993 Thomas G. Vavoso
  8.                                President, EnGamma
  9.                                All Rights Reserved
  10.  
  11.                               2407 Cameron Mills Rd.
  12.                               Alexandria, Va. 22302-3302
  13.  
  14.                             Telephone (703)548-6869
  15.                             Compuserve: 71674,1747
  16.                               GEnie: T. Vavoso
  17.  
  18.           File Finder/Grouper (FFG) performs three basic functions:
  19.            
  20.             1)  Searches disks/archive files for files based on flexible
  21.                 user-specified search criteria
  22.             2)  Groups files for subsequent batch processing as a unit.
  23.             3)  Groups files for building databases of files
  24.  
  25.           If you think you already have a utility program that fills these
  26.           functions, try the DEMO programs and read the section "FFG
  27.           Compared to Other File Finders", before you decide to put FFG
  28.           aside.
  29.  
  30.           If you want to start using FFG right away read the "Quick Start"
  31.           section below.  Otherwise, skip to "Introduction".  
  32.  
  33.           Be sure to read the "Shareware" notice on the next page.
  34.  
  35.  
  36.  
  37.  
  38.                             
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                             
  52.  
  53.  
  54.           File Finder/Grouper             1                     (c) EnGamma
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                       Shareware
  61.  
  62.                Shareware distribution gives users a chance to try software
  63.           before buying it.  If you try a shareware program and continue
  64.           using it, you are expected to register.  Individual programs
  65.           differ on details -- some request registration while others
  66.           require it, some specify a maximum trial period.  With
  67.           registration, you get anything from the simple right to continue
  68.           using the software to an updated program with printed manual.
  69.  
  70.                Copyright laws apply to both shareware and commercial
  71.           software, and the copyright holder retains all rights, with a few
  72.           specific exceptions as stated below.  Shareware authors are
  73.           accomplished programmers, just like commercial authors, and the
  74.           programs are of comparable quality.  (In both cases, there are
  75.           good programs and bad ones!)  The main difference is in the
  76.           method of distribution.  The author specifically grants the right
  77.           to copy and distribute the software, either to all and sundry or
  78.           to a specific group.  For example, some authors require written
  79.           permission before a commercial disk vendor may copy their
  80.           shareware.
  81.  
  82.                Shareware is a distribution method, not a type of software. 
  83.           You should find software that suits your needs and pocketbook,
  84.           whether it's commercial or shareware.  The shareware system makes
  85.           fitting your needs easier, because you can try before you buy. 
  86.           And because the overhead is low, prices are low also.  Shareware
  87.           has the ultimate money-back guarantee -- if you don't use the
  88.           product, you don't pay for it.
  89.  
  90.           e     FFG is a copyrighted shareware program by Thomas G. Vavoso,
  91.           President, EnGamma.  The evaluation edition of FFG is offered at
  92.           no chargeto any potential user for evaluation.  Feel free to
  93.           share the evaluation edition with your friends and associates,
  94.           but please do not give it away altered or as part of another
  95.           system.  The essence of "user-supported" software is to provide
  96.           personal computer users with quality software without high
  97.           prices, and yet to provide incentive for programmers to continue
  98.           to develop new products.
  99.  
  100.  
  101.                                 Disclaimer of Warranty
  102.  
  103.           Users of FFG must accept this disclaimer of warranty:  FFG is
  104.           supplied as-is.  The author disclaims all warranties, expressed
  105.           or implied, including, without limitation, the warranties of
  106.           merchantability and of fitness for any purpose.  The author
  107.           assumes no liability for damages, direct or consequential, which
  108.           may result from the use of FFG.
  109.  
  110.  
  111.  
  112.  
  113.           File Finder/Grouper             2                     (c) EnGamma
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                      Quick Start
  120.  
  121.           1.  Demonstrations - The quickest way to become familiar with FFG
  122.           or to get ideas for possible uses is run the DEMO program
  123.           (DEMO.BAT).  Go to the disk and directory with the demo batch
  124.           files in it and enter:
  125.  
  126.               demo
  127.  
  128.           2.  Command Syntax
  129.  
  130.           USAGE: FFG [DriveSpec:][PathSpec]NameMask[,NameMask2...][\] [options]
  131.  
  132.           "NameMask" can contain one or more extended DOS wild card
  133.           characters to specify the file name:"
  134.  
  135.                        * = matches any string of zero or more characters"
  136.                        ? = matches any one character
  137.  
  138.           "DriveSpec" can be more than a simple drive letter: 
  139.             - If a '*' is substituted for a drive letter, all but A: & B:
  140.               are searched and redundant logical (substitute) drives are
  141.               skipped.
  142.             - Multiple drives can be explicitly specified (e.g., A-D:,
  143.               BDF:).
  144.             - Drives listed after the '*' are excluded (e.g., *M: searches
  145.               all but M:).
  146.  
  147.           - To search for directories instead of files, put a '\' after
  148.             the NameMask
  149.           - Pressing <ESC> will stop the search.  Pressing 'G' will go to
  150.             (Change Dir) the last found file.  Pressing any other key will
  151.             pause the search operation.
  152.           - Either '-' or '/' are acceptable command line option switches.
  153.           - Options may be in any order, before or after the Search Mask.
  154.           - There should be no spaces between option switches and their
  155.             parameters.
  156.  
  157.           3.  Built-in Help/Examples - To get a listing of options and
  158.           command syntax, at the DOS prompt enter:
  159.  
  160.              ffg
  161.  
  162.           4.  Finding a File on the Current Drive - To find a file anywhere
  163.           on the current drive enter:
  164.  
  165.              FFG filename.ext                         
  166.  
  167.             where "filename.ext" is the name of the file you want to find.
  168.  
  169.           5.  Finding a File on All Hard Drives - To find a file anywhere
  170.           on hard drives connected to your system enter:
  171.  
  172.           File Finder/Grouper             3                     (c) EnGamma
  173.  
  174.  
  175.  
  176.  
  177.  
  178.              FFG *:filename.ext                           
  179.  
  180.             where the '*' is interpreted to mean all non-logical disk
  181.             drives except A: and B:, which are assumed to be floppy
  182.             drives.
  183.  
  184.  
  185.           6.  Finding a File on All Drives (including floppies) - To find a
  186.           file anywhere on the system drives enter:
  187.  
  188.              ffg ab*:filename.ext                             
  189.  
  190.             where "ab*" is interpreted to mean search drives A: and B: plus
  191.             all hard drives.
  192.  
  193.           7.  Searching Inside Archive Files (e.g., .ZIP files) - To search
  194.           all drives and inside all archive files on those drives type:
  195.  
  196.              ffg  *:filename.ext /z                              
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.           File Finder/Grouper             4                     (c) EnGamma
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                                      Introduction
  238.  
  239.           To get a quick idea of FFG's capabilities run the batch files
  240.           included in DEMOBAT.ZIP.
  241.  
  242.           Here is a basic list of features:
  243.  
  244.           - Perform filename searches using extended DOS wild card
  245.             characters * and ?.  For example you can file all files with
  246.             "doc" anywhere in the name.  This search is not possible using
  247.             standard DOS wildcard conventions.
  248.  
  249.           - Easily search all disk drives or only selected drives.
  250.  
  251.           - Search for files based on file name, date, time, size, and
  252.             attributes (hidden/system/read only/archive)
  253.  
  254.           - Searches popular archive/compressed file formats such as those
  255.             created with PKZip.
  256.  
  257.           - Can execute an arbitrary DOS command for each found file.
  258.  
  259.           -   Versatile and Customizable Output Formats:
  260.  
  261.              -  Standard columnar output, which is a basic fixed field
  262.                 output of the various file information items:
  263.  
  264.               FILENAME.EXT 12345  1/01/92 23:59 HSRA C:\DIRECT\SUBDIR
  265.  
  266.              -  Packed format, which allows formation of list files for
  267.                 subsequent processing (e.g., PKZip @file):
  268.  
  269.               C:\DIRECT\SUBDIR\FILENAME.EXT
  270.  
  271.              -  Comma delimited ASCII database file format, which allows
  272.                 databases of found files to be built:
  273.  
  274.               "FILENAME.EXT","12345","1/01/92","23:59:00","HSRA","C:\DIRECT\SUBDIR\" 
  275.  
  276.              -  Batch file processing format, which allows sophisticated
  277.                 manipulation of found files as a group:
  278.  
  279.               %1 C:\PATH\FILENAME.EXT %2 %3 %4 %5 %6 %7 %8 %9
  280.  
  281.             Within each of the above basic format types the user can
  282.             further customize the output.  (See the detailed reference for
  283.             the /f option.)
  284.  
  285.           - See the section "FFG Compared to Other File Finders".
  286.  
  287.  
  288.  
  289.  
  290.           File Finder/Grouper             5                     (c) EnGamma
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                           FFG Compared to Other File Finders
  297.  
  298.           File Finder/Grouper (FFG) performs functions similar to those
  299.           found in other utility programs, but here are some FFG features
  300.           that some other file finders lack:
  301.  
  302.           1.  FFG uses the DOS wildcard characters '*' and '?' but they
  303.               have extended function over the DOS counterparts.  The
  304.               extended functionality permits you to search for strings of
  305.               characters that appear anywhere in the file name.
  306.  
  307.           2.  FFG can search for multiple file specifications in a single
  308.               pass, such as find all BAT, COM and EXE files.
  309.  
  310.           3.  FFG permits you to concisely specify multiple file name
  311.               search masks such as "*[ZIP,ARC,ARJ,LHA]*.[COM,EXE]" to find
  312.               all archiving programs.
  313.  
  314.           4.  FFG permits you to exclude certain file name specifications.
  315.  
  316.           5.  FFG can search all disk drives or selected disk drives.
  317.  
  318.           6.  FFG can search inside of archive files (ZIP, ARC, ARJ, LZH). 
  319.               (FFG also searches inside XEQ COM library files).
  320.  
  321.           7.  FFG can execute and arbitrary DOS command for each file
  322.               found.
  323.  
  324.           8.  FFG finds hidden files and searches hidden directories.
  325.  
  326.           9.  FFG searches inside directories with name extensions (e.g.,
  327.               THISISMY.DIR).  Some file finders do not search these
  328.               directories.
  329.  
  330.           10. FFG can move to the disk and directory of the found file (/g
  331.               option).
  332.  
  333.           11. FFG can search for directories instead of files simply by
  334.               appending a backslash '\' to the search name.
  335.  
  336.           12. FFG can search by a date range, time range, size range using
  337.               intuitive syntax to specify these criteria.
  338.  
  339.           13. FFG can search by the file attributes or combination of
  340.               attributes, such as finding all Hidden Read-Only files.
  341.  
  342.           14. FFG can find files based on the day of the week (i.e., Sun -
  343.               Sat) they were modified/created.
  344.  
  345.           15. FFG can search for files by date relative to today, such as
  346.               all files modified/created 7 to 14 days ago.
  347.  
  348.  
  349.           File Finder/Grouper             6                     (c) EnGamma
  350.  
  351.  
  352.  
  353.  
  354.  
  355.           16. FFG lets you pause (press any key) or interrupt (press
  356.               <ESC>) the search operation at any time.
  357.  
  358.           17. FFG can be used to produce database files of its output
  359.               (ASCII comma-delimited files)(/f, option)
  360.  
  361.           18. FFG provides useful default output format options but
  362.               permits extensive user customization of the output format.
  363.  
  364.           19. FFG can be used to produce output as DOS batch files (.BAT)
  365.               with DOS replaceable parameters (%1 through %9).  The batch
  366.               file can then be used to execute a arbitrary command against
  367.               the group of files such as copy, back up, archive, delete,
  368.               move, edit...).  The power and flexibility of this feature
  369.               is limited only by your imagination.  Although some other
  370.               finders have similar capability, they do not have the same
  371.               flexibility.
  372.  
  373.           20. By default, when FFG is searching all disk drives, it skips
  374.               disk drives that are logical aliases of other physical
  375.               drives that have already been searched.  This avoids reports
  376.               of multiple copies of a file when in fact there is only one
  377.               physical copy of the file.
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.           File Finder/Grouper             7                     (c) EnGamma
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                                   Usage and Examples
  415.  
  416.              FFG [DriveSpec:][PathSpec]NameMask[,NameMask2...][\] [options]
  417.  
  418.           FFG is currently not case sensitive.  However, as features are
  419.           added in future releases case may be used to distinguish options. 
  420.           Therefore, use of lower case is recommended.  In many of the
  421.           examples provided in this manual mixed upper and lower case is
  422.           used for clarity only.
  423.  
  424.           DriveSpec tells FFG which drives to search.  If DriveSpec is not
  425.           specified the current disk is searched.  A simple DOS drive
  426.           letter designation can be specified (e.g., C:) or a list of
  427.           drives can be specified (e.g., ABC:).  Also, a '*' can be used to
  428.           mean all drives except A: and B: and logical substitute drives. 
  429.           When '*' is used, it can be combined with an explicit search list
  430.           (e.g., ab*:); the drives that are explicitly listed will be
  431.           searched first.  If you wish to specify "all drives but..." then
  432.           list the drives to exclude after the '*' (e.g., *cd).  Finally, a
  433.           range of drives may be specified (e.g., a-z:).  If any drives
  434.           that are explicitly specified cannot be accessed, such as empty
  435.           floppy drives, FFG reports them as inaccessible.  See the
  436.           following DriveSpec examples.
  437.  
  438.           PathSpec tells FFG which directory to use as the search starting
  439.           point.  The specified directory and all descendent subdirectories
  440.           will be searched unless the NO RECURSION option (/r) is
  441.           specified.  See the following PathSpec examples.
  442.  
  443.           NameMask gives FFG a file name pattern to look for.  Multiple
  444.           name masks can be specified by separating them with a comma (',')
  445.           sign.  NameMask can use DOS wildcard characters '*' and '?', but
  446.           they have extended functions.  The '*' will match zero or more
  447.           characters and the '?' will match exactly one character.  The
  448.           period that separates the file first name and the filename
  449.           extension is treated as any other character in the name.  If a
  450.           terminating backslash is appended to the list of NameMasks, FFG
  451.           will search for directories in lieu of files.  See the following
  452.           NameMask examples.
  453.  
  454.           NameMasks can also include alternative patterns to concisely
  455.           specify multiple masks that have common elements.  For example,
  456.           rather than specify "*.BAT,*.COM,*.EXE", you can use
  457.           "*.[BAT,COM,EXE]".  The bracketed contain different possible
  458.           alternatives for that part of the NameMask.  Brackets can be
  459.           nested.  Here are two more complicated examples:
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.           File Finder/Grouper             8                     (c) EnGamma
  468.  
  469.  
  470.  
  471.  
  472.  
  473.             1.  Let's say you want to see all files which have names that
  474.           are variants of "CONFIG" or an abbreviation of it.  Here's how
  475.           you might specify it: "*C[[O,]N,]F[I,]G*", 
  476.  
  477.             which is equivalent to specifying:
  478.  
  479.               "*CONFIG*,*CONFG*,*CNFIG*,*CNFG*,*CFIG*,*CFG*"
  480.  
  481.             2.  Let's say you want a listing of all archiving programs,
  482.           including batch files that perform and archiving function. 
  483.           Here's how you could spefify it:
  484.  
  485.               "*[ZIP,ARC,ARJ,LHA,PAK,ZOO]*.[EXE,COM,BAT]"
  486.  
  487.             The above is equivalent to specifying 18 separate NameMasks:
  488.  
  489.               "*ZIP*.EXE,*ZIP*.COM,*ZIP*.BAT,...,*ZOO*.COM,*ZOO*.BAT"
  490.  
  491.           NOTE: Slashes can be used instead of commas as in
  492.                 "*.[BAT/COM/EXE]".  This permits a NameMask to be passed
  493.                 to FFG as a parameter to a batch file.  This would not
  494.                 otherwise be possible using commas because DOS considers
  495.                 the comma to be a batch file command-line argument
  496.                 delimiter.
  497.  
  498.           Drive Specifier (DriveSpec) Examples:
  499.  
  500.           These examples illustrate the different ways to specify which
  501.           disk drives should searched.
  502.  
  503.           ffg  filename      -  Searches current drive
  504.  
  505.           ffg  c:filename    -  Searches drive C:
  506.  
  507.           ffg  *:filename    -  Searches all drives but A:, B:, and logical
  508.                                 substitute drives.
  509.  
  510.           ffg  ab*:filename  -  Searches all drives but logical substitute
  511.                                 drives
  512.  
  513.           ffg  a-z:filename  -  Searches all drives
  514.  
  515.           ffg  ec*:filename  -  Searches E: then C: then all other non-
  516.                                 logical drives but floppies
  517.  
  518.           ffg  *c:filename   -  Searches all non-logical drives but C: and
  519.                                 floppies
  520.  
  521.           ffg d*m-z:filename -  Searches D: then all non-logical drives
  522.                                 except M: through Z:
  523.  
  524.  
  525.  
  526.           File Finder/Grouper             9                     (c) EnGamma
  527.  
  528.  
  529.  
  530.  
  531.  
  532.           File Path Specifier (PathSpec) Examples:
  533.  
  534.           These examples illustrate the different ways to specify the
  535.           directory where the search should start.
  536.  
  537.           ffg  filename      -  Searches from root directory
  538.  
  539.           ffg  \filename     -  Searches from root directory
  540.  
  541.           ffg  \DOS\filename -  Searches from \DOS directory
  542.  
  543.           ffg  .\filename    -  Searches from current directory
  544.  
  545.           ffg  ..\filename   -  Searches from parent of current directory
  546.  
  547.           ffg  \filename /r  -  Searches only the root directory, no
  548.                                 subdirectories
  549.  
  550.           File Name Mask (NameMask) Examples:
  551.  
  552.           These examples illustrate the different ways to search based on
  553.           the file name.
  554.  
  555.           ffg  *.*           -  Searches for all files
  556.  
  557.           ffg  *             -  Searches for all files (identical to *.*)
  558.  
  559.           ffg  *\            -  Searches for all directories
  560.  
  561.           ffg  *bat          -  All files ending in 'BAT' (Finds: BALLBAT,
  562.                                 WOMBAT, AUTOEXEC.BAT...)
  563.  
  564.           ffg  *.bat         -  All files with a '.BAT' extension.  (Finds:
  565.                                 BALL.BAT but will NOT find BALLBAT)
  566.  
  567.           ffg  *read*me*     -  All files with 'read' anywhere in name
  568.                                 followed by 'me' (Finds: READ.ME, PLS-
  569.                                 READ.ME, README, README.COM, READU.NME,
  570.                                 YOUREAD.ME)
  571.  
  572.           ffg  *help*,*hlp* or
  573.           ffg  *h[e,]lp*     -  All files with 'help' or 'hlp' anywhere in
  574.                                 the name.  (Finds: WINHELP.EXE, SETUP.HLP,
  575.                                 PRINTHLP.EXE...)
  576.  
  577.           ffg  *c*f*g*       -  All files with 'c', 'f', and 'g' in order
  578.                                 in name.  (Finds: CONFIG.SYS, MIDIMAP.CFG,
  579.                                 CFGSAVE.DLL, MYCFG.DAT, MYCONFG.FIL...)
  580.  
  581.           ffg  *.            -  Finds extensionless files
  582.  
  583.           ffg  ????.*        -  Finds files with exactly four characters in
  584.  
  585.           File Finder/Grouper             10                    (c) EnGamma
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                 first name.  (Finds: DATA.IN, DATA.OUT,
  592.                                 TASM.EXE, TEST...; Doesn't find: TEST1,
  593.                                 TST.DAT...)
  594.  
  595.           ffg  *bat?*        -  Finds files with 'BAT' anywhere in name but
  596.                                 at the end.  (Finds: BATLIB.COM, MYBAT.DAT,
  597.                                 BALLBATS...; Doesn't find: BALLBAT,
  598.                                 AUTOEXEC.BAT)
  599.  
  600.           ffg  ??????        -  Finds all files having exactly 6 character
  601.                                 names, including the period if the file has
  602.                                 an extension.  (Finds: SCRAPS, GO.BAT,
  603.                                 SAVE.C)
  604.  
  605.           ffg * /x*.bat      -  Finds all files but DOS batch files (.BAT)
  606.  
  607.           ffg *win*\         -  Searches for all directories with 'WIN'
  608.                                 anywhere in the directory name
  609.  
  610.           ffg *arc*.[com,exe]-  Search for all archive programs
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.           File Finder/Grouper             11                    (c) EnGamma
  645.  
  646.  
  647.  
  648.  
  649.  
  650.                 Alphabetical Listing of Command Line Options/Switches
  651.  
  652.           Quick Reference:
  653.  
  654.           Option Switch Function
  655.           /a  Attributes of File
  656.           /b  Beep when file found, prompted, and/or done
  657.           /d  Date of File
  658.           /e  Execute Command for each find
  659.           /f  Format of Output
  660.           /g  Go to directory
  661.           /h  Hidden directories
  662.           /p  Page at a time
  663.           /q  Quiet/no screen output
  664.           /r  Recursion (subdirectory search)
  665.           /s  Size of file
  666.           /t  Time of file
  667.           /x  eXclude Files
  668.           /z  ZIP and other archive file search
  669.           /1  Find only 1 file
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.           File Finder/Grouper             12                    (c) EnGamma
  704.  
  705.  
  706.  
  707.  
  708.  
  709.           Options - Detailed Reference:
  710.  
  711.           /a  Attributes of File
  712.  
  713.           /aAttrMask - include only files matching specified attributes
  714.  
  715.               AttrMask = is a string composed of H,S,R,A,'.'
  716.  
  717.               H = hidden attribute set.
  718.               S = system attribute set.
  719.               R = read-only attribute set.
  720.               A = archive attributes set.
  721.               ! = before one of the above, it means not set
  722.               . = "specified attributes period"; unspecified attributes
  723.                   must not be set; The period must be at the end of the
  724.                   string, e.g. /aHR. = hidden AND read only files with no
  725.                   other attributes set.
  726.  
  727.               Attribute Examples
  728.  
  729.               /aR                   - Read-only files
  730.               /aH                   - Hidden files
  731.               /a!S                  - All but System files
  732.               /aA                   - Files with Archive bit set
  733.               /aHR                  - Files that are both hidden and read-
  734.                                       only
  735.               /aHR.                 - Hidden&Read-only files with no other
  736.                                       attributes set
  737.               /aH!R                 - Hidden files that are not read only
  738.               /a!H                  - Files that are not hidden
  739.               /a!H!R                - Files that are neither hidden or
  740.                                       read-only
  741.               /aHR!S!A              - Files with only hidden and read-only
  742.                                       attributes (same as /aHR.)
  743.  
  744.           /b  Beep - Beeps the system system speaker for specified events 
  745.  
  746.           /b[F][P][D] - Beeps when:
  747.  
  748.               F = a file is found
  749.               P = user is prompted
  750.               D = program is done running
  751.  
  752.                 if /b is specified alone beeps will occur for all of the
  753.                 above
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.           File Finder/Grouper             13                    (c) EnGamma
  763.  
  764.  
  765.  
  766.  
  767.  
  768.           /d  Date of File
  769.  
  770.           /dDateRangeStr - include only files matching specified date range
  771.  
  772.               where DateRangeStr is one of the following:
  773.  
  774.               mm/dd/yy              - only files matching mm/dd/yy
  775.               m1/d1/y1-m2/d2/y2     - only files matching this date range
  776.                                       inclusive
  777.               -mm/dd/yy             - only files on or before this date
  778.               mm/dd/yy-             - only files on or after this date
  779.               T                     - Relative: only files with Today's
  780.                                       date
  781.               nT-Tm                 - Relative: n days before TODAY to m
  782.                                       days after today
  783.               nT-mT                 - Relative: n days before TODAY to m
  784.                                       days before TODAY
  785.               [Su|Mo|Tu|We|...|Sa]  - only file matching specified day of
  786.                                       the week. Can also specify a range in
  787.                                       this way.  Use alone or in addition
  788.                                       to above date options.
  789.  
  790.               Date Examples
  791.  
  792.               /d1/1/93              - Files dated 1/1/93
  793.               /d1/1/80-12/31/80     - Files having a 1980 date
  794.               /d-12/31/92           - Files dated 1992 and earlier
  795.               /d1/1/93-             - Files later than 1992
  796.               /dT                   - Files dated TODAY
  797.               /d6T-T                - Files dated in the last 7 days
  798.               /d14T-7T              - Files dated 7-14 days ago
  799.               /dSu                  - Files dated on a Sunday
  800.               /d6T-T /dFr           - Files dated last Friday
  801.               /d6T-T /dSa-Su        - Files dated last Weekend
  802.  
  803.           /e  Execute Command for each find
  804.  
  805.           /e[!][CommandStr] - Execute a command for each found file.
  806.  
  807.               where CommandStr is either:
  808.  
  809.               1. Not specified, in which case the found file itself is
  810.               executed.  It is assumed the found file is executable,
  811.               otherwise the command will not execute.
  812.  
  813.               2. It is a DOS command string including optional Format
  814.               Specifiers.  The Format Specifiers are the same as those used
  815.               for output formatting (see /f description) except that they
  816.               must be preceded by a '%' character to distinguish them from
  817.               normal characters.  For example, to represent the full file
  818.               name, %n would be used.  Spaces are represented with %_ and
  819.               double quotes are represented by %'.  These two specifiers
  820.  
  821.           File Finder/Grouper             14                    (c) EnGamma
  822.  
  823.  
  824.  
  825.  
  826.  
  827.               are required to avoid DOS interpreting the space and double
  828.               quotes when you enter them as FFG options.  In batch files,
  829.               two percent signs %% are required to avoid having DOS
  830.               interpret the % as a replaceable parameter.
  831.  
  832.               The command is executed from the disk drive and directory of
  833.               the found file.
  834.  
  835.               Confirmation - Normally FFG asks the user to confirm whether
  836.               the command should be executed.  However, if the '!' is
  837.               specified, the command will be executed for all found files
  838.               without asking the user for confirmation.  When conifirmation
  839.               is on, the user is given the following options:
  840.  
  841.                   1. Execute the command
  842.                   2. Skip command execution
  843.                   3. Execute the command and turn off confirmations
  844.                   3. Quit
  845.  
  846.               Execute Command Examples:
  847.  
  848.               /g                    - Execute each found file
  849.                                       w/confirmation
  850.               /g!                   - same as above without confirmation
  851.               /gREN%_%P\%N%_%F.NEW  - => ren d:\path\fname.ext fname.new
  852.               /gDEL%_%P\%N          - => del d:\path\fname.ext
  853.               /gMD NEWSBDIR         - => md newsbdir (make new subdirectory)
  854.               "/gCOPY %P\%N A:"     - => copy d:\path\fname.exe a: (note that
  855.                                       by quoting the entire command option,
  856.                                       including the /g, you can avoid
  857.                                       having to use the space Format
  858.                                       Specifier, %_)
  859.  
  860.           /f  Format of Output
  861.  
  862.           /fxFormatStr
  863.  
  864.               There are four basic types of output formats supported by
  865.               FFG: Columnar output (the default), Packed, ASCII Comma
  866.               delimited and Batch File.  Within each of these types there
  867.               is much flexibility in defining the precise output (see
  868.               Format Strings below).  Examples of each are:
  869.  
  870.               1. Columnar Output (/fc, this is the default format)
  871.  
  872.                 FILENAME.EXT 12345  1/01/92 23:59 HSRA C:\DIRECT\SUBDIR
  873.  
  874.               2. Packed Output (/fp)
  875.  
  876.                 C:\DIRECT\SUBDIR\FILENAME.EXT
  877.  
  878.               3. ASCII Comma Delimited Database Output (/f,)
  879.  
  880.           File Finder/Grouper             15                    (c) EnGamma
  881.  
  882.  
  883.  
  884.  
  885.  
  886.                 "FILENAME.EXT","12345","1/01/92","23:59:00","HSRA","C:\DIRECT\SUBDIR\"
  887.  
  888.               4. Batch File Output (/fb)
  889.  
  890.                 %1 C:\PATH\FILENAME.EXT %2 %3 %4 %5 %6 %7 %8 %9
  891.  
  892.  
  893.               Here is a detailed description of the output formatting
  894.               options:
  895.  
  896.           /fxFormatStr
  897.  
  898.           x = C Column        - Fixed field width columnar output ("NSDTAP"
  899.                                 default)
  900.  
  901.               P Packed        - Merge all fields together ("PN" is default)
  902.  
  903.               , Comma         - Comma-delimited ASCII database format
  904.  
  905.               B Batch File    - Format for batch processing with %1, %2.... 
  906.  
  907.  
  908.               S Summary       - Summary Control - This option determines
  909.                                 whether a summary report is displayed and
  910.                                 is used independent of the other /f option
  911.                                 switches.  The 's' must be followed by '.'
  912.                                 or '!', which have the following meanings:
  913.  
  914.                                 . - Summary only
  915.                                 ! - no summary (good for when you are
  916.                                     redirecting output and don't want the
  917.                                     summary report to be redirected to the
  918.                                     file).  
  919.  
  920.               FormatStr is a string composed of Format Specifiers: n, f, e,
  921.               s, d, t, a, p, '.', 'r', ':', '\' or '_' where:
  922.  
  923.               f   = file First name (e.g. if file is FNAME.EXT then "FNAME"
  924.                     is displayed)
  925.             { c   = Comments/File Descriptive notes
  926.               e   = file Extention (e.g. if file is FNAME.EXT then ".EXT"
  927.                     is displayed)
  928.               s   = Size of file
  929.               d   = Date of file
  930.               t   = Time of file
  931.               n   = Full FileName, including extension (e.g., FNAME.EXT)
  932.               a   = file Attributes e.g. "H-R-" for a hidden and read-only
  933.                     file; *ZIP, *ARC for files found in ZIP and ARC files
  934.               p   = full Path to file, including disk drive (trailing
  935.                     backslash '\' is excluded for all but Comma-delimited
  936.                     output)
  937.               r   = diRectory path without drive (trailing backslash '\' is
  938.  
  939.           File Finder/Grouper             16                    (c) EnGamma
  940.  
  941.  
  942.  
  943.  
  944.  
  945.                     excluded for all but Comma-delimited output)
  946.               .   = period put in output
  947.               _   = blank space
  948.               '   = single quote translated to double quote (/e option
  949.                     only).
  950.               %   = to get a % sign (/e option only)
  951.               \   = backslash directory separator
  952.               :   = drive on which file was found (e.g. C:)
  953.               0-9 = (meaningful with the /fB option only) inserts a
  954.                     corresponding DOS .BAT file replaceable parameter %0-%9
  955.                     (e.g. 1->%1);
  956.  
  957.               Formatting Examples
  958.  
  959.               1. /FCnsdtap displays output in fixed Columns (the default)
  960.               as follows:
  961.  
  962.                   FILENAME.EXT 12345  1/01/92 23:59 HSRA C:\DIR\SUBDIR
  963.  
  964.               2. /FPpn displays results in a Packed format as follows:
  965.  
  966.                   C:\DIR\SUBDIR\FILENAME.EXT
  967.  
  968.               3. /F, displays Comma-delimited results for import into a
  969.               database as follows:
  970.  
  971.                   "FILENAME.EXT","12345","1/01/92","23:59:00","HSRA","C:\DIR\SUBDIR"
  972.  
  973.               4. /FB1_2_p\n_34_5 provides format for later Batch file
  974.               processing:
  975.  
  976.                   %1 %2 C:\DIR\SUBDIR\FILENAME.EXT %3%4 %5
  977.  
  978.               5. /FB1_p\n_f.2 > changext.bat creates a batch file with
  979.               lines as follows:
  980.  
  981.                   %1 C:\DIR\SUBDIR\FILENAME.EXT FILENAME.%2
  982.  
  983.                   Which could then be used as follows to change the
  984.                   extension of all found files to ".NEW":
  985.  
  986.                   changext rename NEW
  987.  
  988.               6. /F, /FS! displays comma-delimited output without summary
  989.               information.
  990.  
  991.               7. /FS. displays summary information only
  992.  
  993.  
  994.           /g  Go to directory of first found file
  995.  
  996.               When this option is used, FFG changes the current disk drive
  997.  
  998.           File Finder/Grouper             17                    (c) EnGamma
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.               and directory to the drive/directory of the first found file. 
  1005.               No other files are found.  If the first found file is in an
  1006.               archive file (/z option used), FFG changes to the disk and
  1007.               directory of the archive file that contains the found file. 
  1008.               If searching for directories instead of files, FFG changes
  1009.               into the found directory (makes it the current directory).
  1010.  
  1011.  
  1012.           /h  Hidden directories
  1013.  
  1014.               /h[.|!]
  1015.  
  1016.               Hidden directories are searched by default.  The following
  1017.               modifications are possible:
  1018.  
  1019.               /h  - toggle hidden directories search option (i.e, hidden
  1020.                     directories will be skipped since the default is to
  1021.                     search them)
  1022.               /h. - only hidden directories are searched
  1023.               /h! - do not search hidden directories 
  1024.  
  1025.  
  1026.           /p##    Page at a time
  1027.  
  1028.               /p[##] pause after every ## lines of output; ## is optional;
  1029.  
  1030.               This option causes output and searching to pause after ##
  1031.               lines of screen output.  If ## is not specified, 23 lines
  1032.               will be assumed.  If ## is set to 0, there will be no pause
  1033.               (as though /p were not used at all).
  1034.  
  1035.               ## = blank    - pause after 23 lines of output.
  1036.               ## = 0        - continuous output - don't pause (this is the
  1037.                               default if /p is not specified)
  1038.               ## = 1        - pause after each found file (useful for
  1039.                               providing an oppurtunity for user interaction
  1040.               ## = other #  - pause after ## lines of output.
  1041.  
  1042.           /q  Quiet - Suppresses all but specified output events
  1043.  
  1044.           /q[M][T][S][F] - Suppresses output for all but:
  1045.  
  1046.               M = Spinning meter
  1047.               T = program title line
  1048.               S = Output summary
  1049.               F = Found File
  1050.  
  1051.                 if /q is specified alone all output is suppressed
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.           File Finder/Grouper             18                    (c) EnGamma
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.           /r  Recursion (subdirectory search)
  1064.  
  1065.               By default FFG recursively searches all descendent
  1066.               directories of the starting directory in the directory tree
  1067.               structure.  When the /r option is used only the starting
  1068.               directory is searched.
  1069.  
  1070.           /s  Size of file
  1071.  
  1072.               /sSizeRangeStr - include only files matching specified size
  1073.  
  1074.               where SizeRangeStr is one of the following:
  1075.  
  1076.               Size                  - only files of this size
  1077.               MinSize-MaxSize       - only files within this size range
  1078.                                       inclusive
  1079.               -MaxSize              - only files this size or smaller
  1080.               MinSize-              - only files this size or larger
  1081.  
  1082.               MinSize, Size, MaxSize can use suffixes K, M, G as
  1083.               abbreviations of 1 Kilobyte, 1 Megabyte, and 1 Gigabyte (e.g.
  1084.               /s1K-25M)
  1085.               Size Examples
  1086.  
  1087.               /s0                   - empty files
  1088.               /s1M-                 - very large files (>= 1 megabyte)
  1089.               /s-500                - tiny files (<= 500 bytes)
  1090.               /s1K-2K               - 1024-byte to 2048-byte files
  1091.  
  1092.  
  1093.           /t  Time of file
  1094.  
  1095.               /tTimeRangeStr - include only files matching specified times
  1096.  
  1097.               where TimeRangeStr is one of the following:
  1098.  
  1099.               hh:mm[:ss]            - only files matching this time
  1100.               h1:m1[:s1]-h2:m2[:s2] - only files within this time range
  1101.                                       inclusive
  1102.               -hh:mm[:ss]           - only files on or before this time
  1103.               hh:mm[:ss]-           - only files on or after this time
  1104.  
  1105.               Times must be specified using a 24-hour clock (i.e, 23:00
  1106.               instead of 11:00 PM).  If seconds are not specified, the
  1107.               seconds field is ignored when testing for a match.  Time
  1108.               ranges may span 0:00 (midnight).
  1109.  
  1110.               Time Examples
  1111.  
  1112.               /t-8:00               - Earlybird files (before 8am)
  1113.               /t17:00-8:00          - After-hours files
  1114.               /t17:00-              - Evening/night files
  1115.  
  1116.           File Finder/Grouper             19                    (c) EnGamma
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.               /t8:00-17:00          - Workday files
  1123.  
  1124.           /x  Exclude Files
  1125.  
  1126.               /xFileMaskList - exclude all files in FileMaskList, 
  1127.  
  1128.               where FileMaskList is a list of file specs separated by ','
  1129.               commas.  For example, /x*.bat,*.exe,*.com or /x*.[bat,exe,com]
  1130.  
  1131.  
  1132.           /z  ZIP and other archive file search
  1133.  
  1134.               /z[.][ArcExtList] - Search inside archive files.
  1135.  
  1136.               .           = search ONLY inside archive files.
  1137.               ArcExtList  = list of file extensions to treat as archives.
  1138.                             e.g.,                                         /zZIP,ARC,LZH,ARJ,COM
  1139.  
  1140.               Archive Examples
  1141.  
  1142.               /zZIP        - Limits archive search to ZIP files
  1143.               /zARC,LZH    - Limits archive search to ARC and LZH files
  1144.               /z.         - Limits search to only archive files
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.           File Finder/Grouper             20                    (c) EnGamma
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.                      Bugs/Known Deficiencies/Future Improvements
  1182.  
  1183.           1.  Options to exclude date, time and size ranges are planned.
  1184.           2.  An option for finding files containing a specified text
  1185.               string is planned.
  1186.           3.  Further date options are planned such as /dLASTYEAR
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.           File Finder/Grouper             21                    (c) EnGamma
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.                                     Miscellaneous
  1241.  
  1242.           1.  Options can be specified using either '/' or '-' as command
  1243.               line switch characters.
  1244.  
  1245.           2.  FFG is not case sensitive, but future releases may
  1246.               distinguish letter case as new features are added.  Use of
  1247.               lower case letters is recommended.
  1248.  
  1249.           3.  During a search the following keys have a special function:
  1250.  
  1251.               <ESC>                 - Aborts/interrupts the search
  1252.               <G>                   - Goes to the disk and directory of the
  1253.                                       last found file.  If searching for
  1254.                                       directories, the found directory will
  1255.                                       be made current.
  1256.               <S>                   - Skips to the next disk drive
  1257.               <B>                   - Causes a beep when search complete
  1258.               any other key         - Pauses the search operation
  1259.  
  1260.           4.  While searching, FFG displays the drive currently being
  1261.               searched and indicates progress with a spinning run meter. 
  1262.               The meter is updated one increment each time a new directory
  1263.               or a new archive file is searched.  When the meter slows, it
  1264.               is indicative of either a directory with many files or an
  1265.               archive file.
  1266.  
  1267.           5.  Summary Report - FFG displays a summary report of the search
  1268.               operation.  It includes:
  1269.  
  1270.                     -  Total bytes inside all found files.
  1271.                     -  Disk space occupied by found files including unused
  1272.                        space due to the disk cluster/block size.  If the
  1273.                        file is in an archive, then there is no adjustment
  1274.                        made for cluster size.
  1275.                     -  Number of directories searched.
  1276.                     -  Number of directories in which files were found
  1277.                     -  File NameMasks used for the search
  1278.                     -  File NameMasks excluded from the search
  1279.                     -  Date/Time/Size/Attribute masks if used
  1280.                     -  Number of archive files searched
  1281.                     -  Number of archive files in which files were found
  1282.  
  1283.           6.  FFG can be renamed.  FFG will recognize the new name and
  1284.               display it in the usage screen if you are using DOS 3.0 or
  1285.               later.
  1286.  
  1287.           7.  Conventions - Several options attach special significance to
  1288.               '!' and to '.'.  Generally, '!' is used to represent
  1289.               "negation"/"logical not"/"turn off".  Generally '.' is used
  1290.               to represent "only"/"these period"/"no others".
  1291.  
  1292.  
  1293.           File Finder/Grouper             22                    (c) EnGamma
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.           8.  FFG was developed using Borland C++ 3.1.
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.           File Finder/Grouper             23                    (c) EnGamma
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.                                    Revision History
  1359.  
  1360.           For those who are interested here is how FFG has evolved:
  1361.  
  1362.           Vers   Date     Description of Change
  1363.  
  1364.           1.53    8/4/93  -    Adds range capability to day-of-week date specs (e.g., /dSA-SU)
  1365.                           -    Adds NOT capability for attributes switch
  1366.                           -    Fixes bug (since 1.52) that caused /a switch to not work
  1367.           1.52   7/29/93  -    Overrides recursion switch (/r) if a wildcard path is used
  1368.                           -    Adds limited wild path capability
  1369.                           -    Keeps running meter visible when output redirected to a file
  1370.                           -    Improves Archive search speed for small archived files
  1371.                           -    Improves Archive search efficiency
  1372.                           -    Adds on-the-fly ability to turn on beep-when-done switch
  1373.                           -    Further modularization of display functions
  1374.                           -    Puts commas in all summary numbers
  1375.                           -    Speeds up search when NameMask can use DOS wildcard conventions
  1376.                           -    Adds Z format specifier to enabling using archive name in output & commands
  1377.                           -    Permits use of '/' in lieu of ',' for separating bracketed alternatives. Needed
  1378.                                to avoid having DOS interpret the comma as a delimiter when FFG NameMask is
  1379.                                specified as an argument to a batch file.
  1380.                           -    More graceful handling of errors in use of brackets with alternatives.
  1381.                           -    Adds capability to specify bracketed alternatives: *[zip,arc]*.[com,exe,bat]
  1382.                           -    Improves appearance of directory search output so that all subdirs at one level
  1383.                                are displayed together.
  1384.                           -    Adds ability to specify double qoute with /e as %'
  1385.                           -    Further internal modularization
  1386.                           -    Adds /1 "Find One Only" option
  1387.                           -    Adds a /b "Beep" option for beep on F-ind, P-rompt, D-one
  1388.                           -    Fixes bug w/ /p when 0 or non-number specified which cause divide error
  1389.           1.51    6/7/93  -    Added /e "Execute Command" switch
  1390.                           -    Switched to large memory model and size changed from 80K->110K
  1391.                           -    Fixed bug where archive files streams weren't being closed properly
  1392.                           -    Attributes field for files in Archives now shows archive type (e.g., *ZIP, *LZH)
  1393.                           -    Improves response to user keypresses during search inside
  1394.                                archives
  1395.                           -    /e Executes commands from disk/directory of found file
  1396.                           -    Adds Quiet option /q w/options (m,f,s,t) to restore display of meter, files,
  1397.                                summary, title
  1398.                           -    Adds a skip remainder of drive search feature
  1399.                           -    Further modularizes FFG
  1400.                           -    Fixes bug in /q switch, which wasn't suppressing found files
  1401.           1.50   5/10/93  -    Fixes bug where /g option did not change into found directory
  1402.           1.49    5/9/93  -    Cause all drive not ready errors to be ignored (Failed)
  1403.                           -    Determines whether drives are logical drives at one time to improve the
  1404.                                reliability of the logical drive determination
  1405.                           -    Fixed bug where only first of multiple drive ranges in DriveSpec were considered.
  1406.                                For example, a-df-z:*.* would have searched only drives A:-D:
  1407.           1.48    5/8/93  -    Fixes bug where "/fb." displays 0s and 1s instead of a period '.'
  1408.  
  1409.  
  1410.  
  1411.                  File Finder/Grouper             24                    (c) EnGamma
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.                          -    Adds result codes: 1 = found, 0 = not found (and others for errors)
  1418.                          -    Adds new output format specifier 'n' for full file name (same as "f.e")
  1419.                          -    Changed Abort/interrupt message to appear even if summary display turned off
  1420.           1.47   5/4/93  -    Adds "Bytes Occupied" based on disk cluster size to summary report
  1421.           1.46   5/1/93  -    Fixes bug where root directory files were reported to be in current directory
  1422.                          -    Updated help screens
  1423.           1.45  4/27/93  -    Improves speed of archive file searches
  1424.           1.44  4/22/93  -    Adds ability to search by day of the week on files were last modified or created
  1425.           1.43  4/14/93  -    Fixes bug where trailing backslash was displayed when ':' used as an output
  1426.                               format specifier
  1427.           1.42  4/14/93  -    Allows extensionless files/dirs to be found without putting period in spec
  1428.                          -    Made some display changes including:
  1429.                          -    no terminating period '.' is displayed for extensionless files
  1430.                          -    Adds '\' as format string specifier so it can be appended to the directory path
  1431.                               as a separator (needed mainly for subsequent batch processing because some DOS
  1432.                               command and programs choke on the trailing backslash.
  1433.                          -    User-specified batch file output is packed by default
  1434.                          -    Adds key to resume screen-Page-at-time feature from paused screen
  1435.           1.41  4/12/93  -    Adds directory name search capability w/ '\'
  1436.                          -    Other internal improvements
  1437.           1.40   4/1/93  -    No significant changes
  1438.           1.39   4/1/93  -    Adds capability to search .ARJ archives
  1439.                          -    Fixes bug where *. didn't find extensionless files
  1440.           1.38  3/29/93  -    Cleans up old ARC file searches so garbage files not reported as found in archive
  1441.                          -    Fixes bug in skipping to next file in an archive file
  1442.                          -    Fixes bug in ARC search, which missed SQUASHED files
  1443.           1.37  3/29/93  -    Adapts GoTo function semantics for archive file searches, so it changes to the
  1444.                               directory containing the archive file
  1445.           1.36  3/28/93  -    Adds capability to search XEQ.COM libraries with /z option
  1446.                          -    Adds archive extension list to /Z so that the archive file types to search can be
  1447.                               explicitly specified, e.g. /zZIP+ARC
  1448.                          -    Changed name from Flexible File Finder (FFF.EXE) when a PC Magazine Utility by
  1449.                               the same name and similar function was discovered.
  1450.           1.35  3/27/93  -    Adds capability to search .ARC archives (ARC, PKARC)
  1451.           1.34  3/27/93  -    Adds capability to search .LZH archives (LHARC)
  1452.           1.33  3/21/93  -    Adds archive /Z (only ZIP for now) file capability (PKZIP)
  1453.           1.32   3/3/93  -    Improves Today feature to handle Today + n (Tn), Today - n (nT)
  1454.           1.31   3/1/93  -    Adds "Today" feature to date switch, e.g. /dt for all files with today's date
  1455.           1.30  2/23/93  -    Fixes bug with time switch, /t
  1456.           1.29  2/15/93  -    Tunes spinning run meter
  1457.                          -    Updates formatting examples for rev 1.25-1.26 /fb features
  1458.                          -    Implements the running meter as separate "SpinMeter" class/object
  1459.                          -    Editorial changes to summary output formatting
  1460.                          -    Changed K suffix to mean 1024 bytes vice 1000 and similar changes for M, G
  1461.                               abbreviations in file size
  1462.                          -    Fixed extra file display bug when ESC pressed from pause screen (bug from v1.22
  1463.                               GoTo mods)
  1464.           1.28  2/12/93  -    Adds spinning run meter to indicate program is working and not hung
  1465.           1.27   2/8/93  -    Fixes /fb (Batch File) format to enable more than just file.ext output
  1466.                          -    Adds ':' (Drive) and 'R' (Directory) formatting options so these subelements of
  1467.                               the path can be extracted
  1468.           1.26   2/7/93  -    Fixes bug with time /t switch that causes hours > 16 to be treated as h-16
  1469.  
  1470.                  File Finder/Grouper             25                    (c) EnGamma
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.                          -    Allows /t Time Range to span midnight such as 23:00-01:00
  1477.           1.25   2/4/93  -    Adds Batch file output format /fB
  1478.           1.24   2/4/93  -    Adds ability to expand drive ranges A-D: -> ABCD:
  1479.                          -    Changes output format type specifiers for Column 0->C, Packed 1->P, Summary !->S
  1480.           1.23  1/31/93  -    Improved summary display
  1481.                          -    Fixed bug associated with displaying large (100M+) files
  1482.                          -    Added directory count tally to summary
  1483.           1.22  1/28/93  -    Adds internal option (not yet implemented for user) to treat no drive spec as *:
  1484.                               (all drives)
  1485.                          -    Adds user GoTo interrupt which changes to directory of most recent found file
  1486.           1.21  1/26/93  -    Removed case sensitivity of command line switches
  1487.           1.20  1/25/93  -    Fixes bug (v1.16) where non-wild specs aren't found!
  1488.           1.19  1/25/93  -    Adds additional usage/help screens
  1489.           1.15 12/07/92  -    Restores function recursion switch /r which was inadvertently deleted in 1.14
  1490.                          -    Adds hidden directory search switch and searches hidden directories
  1491.                          -    Adds /f! to suppress summary info display
  1492.           1.18  1/23/93  -    Uses + to separate multiple filespec masks
  1493.           1.17  1/23/93  -    Adds capability to specify multiple exclude filespec  masks
  1494.           1.16  1/23/93  -    Adds capability to search for multiple filespec masks
  1495.           1.14 12/06/92  -    Object-oriented improvements
  1496.                          -    Fixes bug introduced in 1.13 which caused /g switch to not work
  1497.           1.13 11/24/92  -    Fixes bug where drives are accessed even after <ESC> is pressed
  1498.           1.12 11/24/92  -    Fixes bug with /g switch when file is in root directory
  1499.                          -    Fixes bug where one file per drive is found after <ESC> pressed
  1500.           1.11 11/22/92  -    Adds comma-delimited ASCII database format
  1501.                          -    Improves default output formatting for /f, /f0 /f1
  1502.           1.10 11/21/92  -    Improves User keyboard pausing/interrupt.
  1503.           1.09 11/18/92  -    Adds /t (time range) switch
  1504.                          -    Adds /g (GoTo) switch
  1505.           1.08 11/17/92  -    Adds /a (attribute) switch - improved
  1506.                          -    Adds /d (date range) switch
  1507.           1.07 11/16/92  -    Adds /s (size range) switch
  1508.           1.06 11/16/92  -    Internal Programming methodology changes
  1509.                          -    Adds /r (no recursion) switch
  1510.           1.05 11/15/92  -    Adds ability to specify drives before wildcard drive: ab*lmn
  1511.           1.04 11/14/92  -    Adds command line parameter capability
  1512.                          -    Adds /x (exclude spec) switch
  1513.                          -    Adds limited attribute filtering (-a)
  1514.                          -    Adds /p (screen pauses with prompt) (-p##)
  1515.                          -    fixed bug where mask is longer than prospect file *????????*
  1516.           1.03 11/11/92  -    Formats "bytes occupied" with commas
  1517.                          -    Adds file attributes to display
  1518.           1.02 11/09/92  -    Fixes bug that causes root directory files to appear in default directory
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.           File Finder/Grouper             26                    (c) EnGamma
  1530.