home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 299.lha / FileFind_v1.5 / ff.txt < prev    next >
Encoding:
Text File  |  1980-12-06  |  5.5 KB  |  122 lines
  1.  
  2.                               FileFind Amiga!
  3.                                 Version 1.5
  4.  
  5.                            Created by Ray Lambert
  6.  
  7.  
  8.   FileFind is a CLI utility which will search for files on filing devices
  9. using wildcards.  The MS-DOS wildcards "*" and "?" can be used as well as
  10. the AmigaDOS wildcard "#".  The drive specifier is optional and if not
  11. supplied the currently logged drive is used.  An optional directory
  12. specifier may also be used which limits the search to the specified
  13. directory and all sub-directory levels under it.  Multiple arguments may be
  14. supplied to search on more than one drive for a particular file, or to
  15. search for multiple files on multiple devices.  Ctrl-C may be used to
  16. immediately terminate the search and return your CLI prompt to you.  Version
  17. 1.5 is pure and as such can be made resident under AmigaDOS 1.3 or under
  18. AmigaDOS 1.2 using ARP.
  19.  
  20.  
  21.   NEW TO VERSION 1.5:  I have introduced my own pattern matching routines to
  22. this release.  In most of the previous releases I was using a Lattice
  23. library routine called stcmp() which is really an all-purpose, general
  24. expression parser - it was not completely appropriate for filename-wildcard
  25. matching.  For example, with Lattice's routine, if you entered "FF foo",
  26. Lattice would actually match "foo*", which probably was not what you really
  27. wanted to see.  My routine will literally match "foo" if that is what you
  28. enter, or "foo*" if that is what you enter.  The new routine was written
  29. specifically for filename pattern matching which makes it more appropriate
  30. for use in FileFind.  It is a little larger than Lattice's stcmp(), and
  31. subsequently has increased the executable code size a bit, but it appears to
  32. be faster and certainly behaves more appropriately.  The new routine
  33. supports the following wildcard characters:
  34.  
  35.             ?   - matches one of any character.
  36.             #x  - matches one or more occurances of "x", which can be
  37.                   any valid character.
  38.             *   - matches any number of any characters.
  39.             #?  - a special case of "#x" which works the same as "*".
  40.  
  41.  
  42.   In addition to the new wildcard matching routine just discussed, version
  43. 1.5 supports a pair of command line switches:
  44.  
  45.                         -q : enables "Quiet Mode"
  46.                         -v : enables "Verbose Mode"
  47.  
  48.   When "Quiet Mode" is enabled "Searching..." messages (which normally
  49. appear to display the name of each directory that FileFind searches in) are
  50. suppressed.  "Verbose Mode" is just the opposite of "Quiet Mode" and is the
  51. default.  The two switches may appear anywhere on the FileFind command line.
  52. They may be intermixed between all other command line input thus allowing
  53. the use of "Quiet Mode" for some searches and "Verbose Mode" for others in
  54. the same invocation of FileFind.
  55.   If you find that you prefer "Quiet Mode" all the time let me remind of the
  56. aliasing capability of the AmigaDOS 1.3 Shell.  An alias can be easily
  57. created to invoke FileFind in Quiet Mode all the time.  For Example:
  58. "Alias FF FileFind -q []".
  59.  
  60.  
  61.                               Usage examples:
  62.                               --------------
  63.  
  64.                  Search for all C source files on "DH0:"...
  65.  
  66.                               FileFind DH0:*.c
  67.  
  68.         Search for all files with the word "disk" in them in "c:"...
  69.  
  70.                              FileFind c:*disk*
  71.  
  72.      Search for all Workbench icon files (.info) on "DH0:" and "DH1:".
  73.          Make the search on "DH0:" "quiet" and "DH1:" "verbose"...
  74.  
  75.                     FileFind -q dh0:*.info -v dh1:*.info
  76.  
  77.  
  78.   This release includes the source code for those of you who want to
  79. experiment a bit.  The source will only compile with Lattice Version 5.0x, as
  80. it uses very Lattice-specific tricks to gain maximum speed and minimum code
  81. size (6252 bytes), however it can be converted to compile with Manx.  See
  82. the makefile for compiling instructions.
  83.   Anyone is welcome to improve/enhance FileFind in any way, however I ask
  84. that if you distribute derivative works that you give me some credit for the
  85. original work.  I would also greatly like to see the cosmic improvements
  86. that you make!
  87.  
  88.  
  89.   A note about the name:  The first version of FileFind was released BEFORE
  90. AmigaDOS 1.3 which contains the program FastFonts.  FileFind has always been
  91. called FF to minimize typing required to invoke the program.  FastFonts was
  92. always called FastFonts until it was released with AmigaDOS 1.3 when it was
  93. renamed to FF.  You must be aware of this potential naming conflict if you
  94. intend to use FileFind.  If you attempt to copy FileFind to your c:
  95. directory as FF, and FastFonts already exists there as FF, the COPY command
  96. will silently overwrite FastFonts with FileFind without your ever knowing.
  97. I suggest that you rename either FileFind or FastFonts to something that
  98. won't conflict.  I am in favor of renaming FastFonts because it is normally
  99. only executed once per session and that is in your startup-sequence file,
  100. however FileFind may be executed many times in a session and it will save
  101. you some typing if it is called FF.  See the RENAME command in your AmigaDOS
  102. manual if you're not sure how to do this.
  103.  
  104.  
  105.   FileFind is copyrighted to the author, Ray Lambert, and is released as
  106. public domain.  It may be freely redistributed as long as this file goes
  107. along with it.  FileFind may not be sold commercially without permission
  108. from the author.
  109.  
  110.  
  111. If you have questions, complaints, suggestions, propositions, etc., you may
  112. contact me at the following places:
  113.  
  114. PLink:        Analog*Kid
  115.  
  116. U.S. Snail:   Ray Lambert
  117.               415 Sanford Road
  118.               Westport, Massachusetts  02790
  119.  
  120. Phone:        (508) 672-8232
  121.  
  122.