home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d102 / match_stuff.lha / Match_Stuff / README < prev    next >
Text File  |  1987-09-06  |  3KB  |  70 lines
  1.  
  2. This package contains a comprehensive String and File Matching program,
  3. "Mat",and some EXECUTE Command Scripts which use it.
  4.  
  5. [The nature of the program means that it needs a command line -- it can't
  6. be run from an icon. This README file and the two .DOC files are the only
  7. WorkBench accessible files in this directory.]
  8.  
  9. Mat's notation for patterns is an extension of the standard AmigaDOS
  10. convention (used by LIST, COPY, and DELETE etc.). It uses additional
  11. special characters for negation and for marking the matched string into
  12. "slices".
  13.  
  14. To provide the flexibility that Mat has, its command line syntax has to be
  15. fairly complex.  In most cases you will probably want prewritten command
  16. scripts to perform common actions; some examples are included.  [Warning!
  17. Commercial message on rapid approach vector...!]  This program becomes much
  18. friendlier if you are using Sili(Con:); in the first place because command
  19. scripts are used like any other command (no "EXECUTE"...), and in the
  20. second because you can enter a complex command line for a special Mat job
  21. once and then use it repeatedly (or with modifications) by clicking on it
  22. with the mouse.  Sili(Con:) is probably also on this disk, so check it out,
  23. but remember it is Shareware (unlike this program which is free for all
  24. non-profit use).
  25.  
  26. The main contents of this package are as follows:
  27.  
  28.     Mat             --  A general purpose string and file matching utility
  29.                         with the ability to slice and rearrange the input.
  30.  
  31.     Mat.DOC         --  The user's manual for Mat.
  32.  
  33.     REN             --  Command script for extended renaming of multiple
  34.                         files.
  35.     REF             --  Example command script to highlight references
  36.                         in text.
  37.     PR              --  Command script to print specified files in the
  38.                         background.
  39.     UPDATE          --  Command script to invoke "xcopy" with full pattern
  40.                         matching on file names.
  41.  
  42.     Scripts.DOC     --  Instructions for using the command scripts.
  43.                         [I suggest you try using the scripts before
  44.                         plunging into the syntax of Mat!]
  45.  
  46. Sources:
  47.     Mat.c
  48.     Match.c         --  The extended AmigaDOS type matching algorithm used.
  49.     Splicer.c       --  String slicing, dicing, and splicing.
  50.     Splicer.h       --  Splicing structure definition
  51.  
  52.     Match.c_BCPL    --  A direct translation into C of the original
  53.                         algorithm.
  54.  
  55. These sources have only been compiled under Lattice 3.10.  Match is
  56. SUPPOSED to be portable (!), but Mat may not be.
  57.  
  58. I apologize for the lack of documentation on the matching algorithm.  It
  59. really needs a tutorial --- which I hope maybe to be able to supply later.
  60. In the meantime you'll have to piece it together from the code and how Mat
  61. uses it.
  62.  
  63. Mat itself is copyright, but freely distributable for non-profit purposes.
  64. I consider the Match code to be public; it was derived from someone else's
  65. published work after all... (see the reference in the source code).
  66.  
  67.                                             Peter Goodeve
  68.                                             August 1987
  69.  
  70.