Home » Archimedes archive » Acorn User » AU 1997-10 A.adf » Extras » Apple][e/PD/FileMatch/!FileMatch/!Help

Apple][e/PD/FileMatch/!FileMatch/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1997-10 A.adf » Extras
Filename: Apple][e/PD/FileMatch/!FileMatch/!Help
Read OK:
File size: 2AAB bytes
Load address: 0000
Exec address: 0000
File contents
  Title: FileMatch
Purpose: Intelligent File Finding
 Author: � Sanjay Pattni 1989-1996
Version: 1.01 (20-03-96)

********************************************************************************
*                                                                              *
*                                    Licence                                   *
*                                    ~~~~~~~                                   *
*     A personal licence is granted as follows:                                *
*                                                                              *
*     Definitions                                                              *
*     ===========                                                              *
*     Software: Software means all parts of FileMatch and it's resource        *
*               files                                                          *
*                                                                              *
*     Conditions                                                               *
*     ==========                                                               *
*                                                                              *
*     This software is Copyright Sanjay Pattni 1989 - 1996.                    *
*     All rights reserved.                                                     *
*                                                                              *
*     (1) You may not incorporate any part of the software into any            *
*         other programs.                                                      *
*                                                                              *
*     (2) You may not disassemble, reverse engineer, decompile or make         *
*         any attempt to discover the source code of the software.             *
*                                                                              *
*     (3) You may freely distribute this software if:                          *
*         (a) you do not make any profit from doing this.                      *
*         (b) you are a software library and you do not make a profit          *
*             of more than 25% of the price that you charge.                   *
*                                                                              *
*         In all other circumstances you may distribute this software          *
*         if, and only if, you have Sanjay Pattni's explicit permission        *
*         to distribute this software.                                         *
*                                                                              *
*     (4) All copies and installations of this software contain this           *
*         file (unedited).                                                     *
*                                                                              *
*     (5) Ownership of this software remains with Sanjay Pattni at all         *
*         times.                                                               *
*                                                                              *
*     (6) This software is provided with no explicit nor implicit              *
*         warranty. Sanjay Pattni does not recommend its fitness for           *
*         for any purpose.                                                     *
*                                                                              *
*     If you do not accept these licence conditions, you must delete all       *
*     your copies of this software.                                            *
*                                                                              *
********************************************************************************


  Abstract:
  =========
    FileMatch is an intelligent file finding utility. It will search a
    directory and try to match file characteristics according to a very
    extensive user specified template. The utility can be used directly
    from the command line or via a WIMP front end.


  Requirements:
  =============
    1MByte or more memory.

    Risc OS 3 or above.

    Risc OS prior to 3.6 requires various Toolbox modules to be soft-loaded:

        Toolbox     1.36
        Window      1.31
        Menu        0.24
        Iconbar     1.12
        ProgInfo    0.09

    Note 1: They are only required by the WIMP based front end, ie. for pure
            command line usage, they are not needed.
    Note 2: They are not supplied with this distribution.



  Front end:
  ==========
    Run !FileMatch for a RISC OS compliant frontend to FileMatch.
    Use Interactive Help for instructions.


  Command Line Syntax:
  ====================
        FileMatch [flag options]^


  Flag Options:
  =============
    (Default is shown in brackets after description)

    -a <Access string>
        <Access string> is a string specifying what access attributes
        should be matched. The format is something like:
            "PlwR/wR"
        The characters to the left of the "/" are owner access attributes.
        The characters to the right of the "/" are public access attributes.
        An upper-case letter specifies that the attribute is ON. A lower-case
        letter specifies that the attribute is OFF. If the attribute is not
        present, it's state will not be matched.
            "P" = Privatised - used on SJ Research MDFS networks
            "L" = Locked
            "W" = Write Access
            "R" = Read Access

    -cs
        Make the wild card search name case sensitive. (default=OFF)

    -d < <min time[ <max time>]> | <relative time string> >
        Match date stamp or date stamp range or relative time range.
        Format of <min/max time> is five bytes of hex, eg. "1a2b3c4d5e"
        where the most significant byte is given first.

        A relative time string is used to specify a time range relative to
        the current time, eg. "thisday".

        There are 5 suffixes, ie. time units:
            "hour"
            "day"
            "week"      My weeks start on a Monday!
            "month"
            "year"

        There are 3 prefixes:
            "this" = the current time unit
            "last" = the previous time unit
            "past" = current time - one time unit
        eg. the current time is 17:47
            "thishour" = 17:00:00.00 -> 17:59:59.59
            "lasthour" = 16:00:00.00 -> 16:59:59.59
            "pasthour" = 16:47:00.00 -> 17:46:59.59

    -e <min address>[ <max address>]
        Match execution address. See note [1], [2].

    -l <min address>[ <max address>]
        Match load address. See note [1], [2].

    -m <file>
        <file> specifies a file which is to used as a template. Note that
        this will override any preceding match parameters.

    -n <wildcarded name>
        <wildcarded name> specifies a wildcarded name to match (default="*")
        "#" = matches any single character
        "*" = matches 0 or more characters

    -o <value>
        Output: (Default = Output nothing)
        Bit 1 = Filename
        Bit 2 = File information

    -ot <object types>
        <object types> is integer specifying objects to match (default=1)
        Bit 0 = Files
        Bit 1 = Directories
        Bit 2 = Image Files

    -p <path>
        <path> specifies directory to start search from. (default=CSD)

    -r
        Recursively search directories (Default = OFF)

    -ri
        Recursively search image files (Default = OFF)

    -s <min size>[ <max size>]
        Match files of given size or size range. See note [1], [2].

    -t <filetype string>
        <filetype string> is filetype to match

    -v
        Verbose (Default = OFF)

    -x "<command>"
        Command to eXecute on matched files - very useful and also very
        dangerous if abused.

        Command Macros:
          "\p" = Path of file,
          "\n" = Name of file,
          "\\" = single "\"


  Examples:
  =========
  * List all files with date stamp of sometime today from CSD and below:

      FileMatch -o 1 -d thisday -r -ri

  * List all files and info on them for files with size of 2457 bytes
    exactly, in the CSD:

      FileMatch -o 3 -s 2457

  * List all files with size in the range 2457 +/- 100 bytes, in the CSD:

      FileMatch -o 1 -s 2457 ++100

  * List all files with load address in the range &3000 to &7fff
    inclusive, in the CSD:

      FileMatch -o 1 -l &3000 &7fff


  Notes:
  ======
  [1] For flags which allow a single value or a range, if a single value
      is given then a match will only occur if the file has exactly this
      value. For a range, a match will only occur if the file has a value
      in the _inclusive_ range given by min and max.

  [2] If an integer is expected for a flag such a described in [1], you
      may prefix the "max" value with the following modifiers:
        "+"  : range_max = first parameter + second parameter
        "+-" : range_max = first parameter - second parameter
        "++" : range_min = first parameter - second parameter &
               range_max = first parameter + second parameter
        "&"  : integer is specified in hexadecimal

  [3] Before starting to search FileMatch will read the CSD status.
      When searching, FileMatch will change the CSD. When FileMatch has
      finished searching it will restore the CSD to the original state.
      To avoid any possible problems occurring, do not change the CSD
      when FileMatch is running. Also, be careful of creating or deleting
      files whilst searching. This may confuse FileMatch and make it
      'lose' it's place.

  [4] CSD = currently selected directory

  [5] In the above descriptions "file" is sometimes used generically to
      mean "files", "directories" or "image files". These places should
      be obvious.

-- 
********************************************************************************
*                                                                              *
*                           Contacting the author                              *
*                           ~~~~~~~~~~~~~~~~~~~~~                              *
*                                                                              *
*     Author: Sanjay Pattni                                                    *
*    Address: 105 Sterling Place London W5 4RD.                                *
*       Tel.: (+44) (0) 181 - 568 9167                                         *
*      Email: s.pattni@ic.ac.uk                                                *
*        WWW: http://www.pp.ph.ic.ac.uk/~spattni/                              *
*                                                                              *
********************************************************************************
00000000  20 20 54 69 74 6c 65 3a  20 46 69 6c 65 4d 61 74  |  Title: FileMat|
00000010  63 68 0a 50 75 72 70 6f  73 65 3a 20 49 6e 74 65  |ch.Purpose: Inte|
00000020  6c 6c 69 67 65 6e 74 20  46 69 6c 65 20 46 69 6e  |lligent File Fin|
00000030  64 69 6e 67 0a 20 41 75  74 68 6f 72 3a 20 a9 20  |ding. Author: . |
00000040  53 61 6e 6a 61 79 20 50  61 74 74 6e 69 20 31 39  |Sanjay Pattni 19|
00000050  38 39 2d 31 39 39 36 0a  56 65 72 73 69 6f 6e 3a  |89-1996.Version:|
00000060  20 31 2e 30 31 20 28 32  30 2d 30 33 2d 39 36 29  | 1.01 (20-03-96)|
00000070  0a 0a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |..**************|
00000080  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000000c0  2a 2a 0a 2a 20 20 20 20  20 20 20 20 20 20 20 20  |**.*            |
000000d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000110  20 20 2a 0a 2a 20 20 20  20 20 20 20 20 20 20 20  |  *.*           |
00000120  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000130  20 20 20 20 20 20 20 20  20 4c 69 63 65 6e 63 65  |         Licence|
00000140  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000160  20 20 20 2a 0a 2a 20 20  20 20 20 20 20 20 20 20  |   *.*          |
00000170  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000180  20 20 20 20 20 20 20 20  20 20 7e 7e 7e 7e 7e 7e  |          ~~~~~~|
00000190  7e 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |~               |
000001a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000001b0  20 20 20 20 2a 0a 2a 20  20 20 20 20 41 20 70 65  |    *.*     A pe|
000001c0  72 73 6f 6e 61 6c 20 6c  69 63 65 6e 63 65 20 69  |rsonal licence i|
000001d0  73 20 67 72 61 6e 74 65  64 20 61 73 20 66 6f 6c  |s granted as fol|
000001e0  6c 6f 77 73 3a 20 20 20  20 20 20 20 20 20 20 20  |lows:           |
000001f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000200  20 20 20 20 20 2a 0a 2a  20 20 20 20 20 20 20 20  |     *.*        |
00000210  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000250  20 20 20 20 20 20 2a 0a  2a 20 20 20 20 20 44 65  |      *.*     De|
00000260  66 69 6e 69 74 69 6f 6e  73 20 20 20 20 20 20 20  |finitions       |
00000270  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000002a0  20 20 20 20 20 20 20 2a  0a 2a 20 20 20 20 20 3d  |       *.*     =|
000002b0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 20 20 20 20 20 20  |==========      |
000002c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000002f0  20 20 20 20 20 20 20 20  2a 0a 2a 20 20 20 20 20  |        *.*     |
00000300  53 6f 66 74 77 61 72 65  3a 20 53 6f 66 74 77 61  |Software: Softwa|
00000310  72 65 20 6d 65 61 6e 73  20 61 6c 6c 20 70 61 72  |re means all par|
00000320  74 73 20 6f 66 20 46 69  6c 65 4d 61 74 63 68 20  |ts of FileMatch |
00000330  61 6e 64 20 69 74 27 73  20 72 65 73 6f 75 72 63  |and it's resourc|
00000340  65 20 20 20 20 20 20 20  20 2a 0a 2a 20 20 20 20  |e        *.*    |
00000350  20 20 20 20 20 20 20 20  20 20 20 66 69 6c 65 73  |           files|
00000360  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000390  20 20 20 20 20 20 20 20  20 20 2a 0a 2a 20 20 20  |          *.*   |
000003a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000003e0  20 20 20 20 20 20 20 20  20 20 20 2a 0a 2a 20 20  |           *.*  |
000003f0  20 20 20 43 6f 6e 64 69  74 69 6f 6e 73 20 20 20  |   Conditions   |
00000400  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000430  20 20 20 20 20 20 20 20  20 20 20 20 2a 0a 2a 20  |            *.* |
00000440  20 20 20 20 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 20 20  |    ==========  |
00000450  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000480  20 20 20 20 20 20 20 20  20 20 20 20 20 2a 0a 2a  |             *.*|
00000490  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000004d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 2a 0a  |              *.|
000004e0  2a 20 20 20 20 20 54 68  69 73 20 73 6f 66 74 77  |*     This softw|
000004f0  61 72 65 20 69 73 20 43  6f 70 79 72 69 67 68 74  |are is Copyright|
00000500  20 53 61 6e 6a 61 79 20  50 61 74 74 6e 69 20 31  | Sanjay Pattni 1|
00000510  39 38 39 20 2d 20 31 39  39 36 2e 20 20 20 20 20  |989 - 1996.     |
00000520  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 2a  |               *|
00000530  0a 2a 20 20 20 20 20 41  6c 6c 20 72 69 67 68 74  |.*     All right|
00000540  73 20 72 65 73 65 72 76  65 64 2e 20 20 20 20 20  |s reserved.     |
00000550  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000580  2a 0a 2a 20 20 20 20 20  20 20 20 20 20 20 20 20  |*.*             |
00000590  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000005d0  20 2a 0a 2a 20 20 20 20  20 28 31 29 20 59 6f 75  | *.*     (1) You|
000005e0  20 6d 61 79 20 6e 6f 74  20 69 6e 63 6f 72 70 6f  | may not incorpo|
000005f0  72 61 74 65 20 61 6e 79  20 70 61 72 74 20 6f 66  |rate any part of|
00000600  20 74 68 65 20 73 6f 66  74 77 61 72 65 20 69 6e  | the software in|
00000610  74 6f 20 61 6e 79 20 20  20 20 20 20 20 20 20 20  |to any          |
00000620  20 20 2a 0a 2a 20 20 20  20 20 20 20 20 20 6f 74  |  *.*         ot|
00000630  68 65 72 20 70 72 6f 67  72 61 6d 73 2e 20 20 20  |her programs.   |
00000640  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000670  20 20 20 2a 0a 2a 20 20  20 20 20 20 20 20 20 20  |   *.*          |
00000680  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000006c0  20 20 20 20 2a 0a 2a 20  20 20 20 20 28 32 29 20  |    *.*     (2) |
000006d0  59 6f 75 20 6d 61 79 20  6e 6f 74 20 64 69 73 61  |You may not disa|
000006e0  73 73 65 6d 62 6c 65 2c  20 72 65 76 65 72 73 65  |ssemble, reverse|
000006f0  20 65 6e 67 69 6e 65 65  72 2c 20 64 65 63 6f 6d  | engineer, decom|
00000700  70 69 6c 65 20 6f 72 20  6d 61 6b 65 20 20 20 20  |pile or make    |
00000710  20 20 20 20 20 2a 0a 2a  20 20 20 20 20 20 20 20  |     *.*        |
00000720  20 61 6e 79 20 61 74 74  65 6d 70 74 20 74 6f 20  | any attempt to |
00000730  64 69 73 63 6f 76 65 72  20 74 68 65 20 73 6f 75  |discover the sou|
00000740  72 63 65 20 63 6f 64 65  20 6f 66 20 74 68 65 20  |rce code of the |
00000750  73 6f 66 74 77 61 72 65  2e 20 20 20 20 20 20 20  |software.       |
00000760  20 20 20 20 20 20 2a 0a  2a 20 20 20 20 20 20 20  |      *.*       |
00000770  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000007b0  20 20 20 20 20 20 20 2a  0a 2a 20 20 20 20 20 28  |       *.*     (|
000007c0  33 29 20 59 6f 75 20 6d  61 79 20 66 72 65 65 6c  |3) You may freel|
000007d0  79 20 64 69 73 74 72 69  62 75 74 65 20 74 68 69  |y distribute thi|
000007e0  73 20 73 6f 66 74 77 61  72 65 20 69 66 3a 20 20  |s software if:  |
000007f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000800  20 20 20 20 20 20 20 20  2a 0a 2a 20 20 20 20 20  |        *.*     |
00000810  20 20 20 20 28 61 29 20  79 6f 75 20 64 6f 20 6e  |    (a) you do n|
00000820  6f 74 20 6d 61 6b 65 20  61 6e 79 20 70 72 6f 66  |ot make any prof|
00000830  69 74 20 66 72 6f 6d 20  64 6f 69 6e 67 20 74 68  |it from doing th|
00000840  69 73 2e 20 20 20 20 20  20 20 20 20 20 20 20 20  |is.             |
00000850  20 20 20 20 20 20 20 20  20 2a 0a 2a 20 20 20 20  |         *.*    |
00000860  20 20 20 20 20 28 62 29  20 79 6f 75 20 61 72 65  |     (b) you are|
00000870  20 61 20 73 6f 66 74 77  61 72 65 20 6c 69 62 72  | a software libr|
00000880  61 72 79 20 61 6e 64 20  79 6f 75 20 64 6f 20 6e  |ary and you do n|
00000890  6f 74 20 6d 61 6b 65 20  61 20 70 72 6f 66 69 74  |ot make a profit|
000008a0  20 20 20 20 20 20 20 20  20 20 2a 0a 2a 20 20 20  |          *.*   |
000008b0  20 20 20 20 20 20 20 20  20 20 6f 66 20 6d 6f 72  |          of mor|
000008c0  65 20 74 68 61 6e 20 32  35 25 20 6f 66 20 74 68  |e than 25% of th|
000008d0  65 20 70 72 69 63 65 20  74 68 61 74 20 79 6f 75  |e price that you|
000008e0  20 63 68 61 72 67 65 2e  20 20 20 20 20 20 20 20  | charge.        |
000008f0  20 20 20 20 20 20 20 20  20 20 20 2a 0a 2a 20 20  |           *.*  |
00000900  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000940  20 20 20 20 20 20 20 20  20 20 20 20 2a 0a 2a 20  |            *.* |
00000950  20 20 20 20 20 20 20 20  49 6e 20 61 6c 6c 20 6f  |        In all o|
00000960  74 68 65 72 20 63 69 72  63 75 6d 73 74 61 6e 63  |ther circumstanc|
00000970  65 73 20 79 6f 75 20 6d  61 79 20 64 69 73 74 72  |es you may distr|
00000980  69 62 75 74 65 20 74 68  69 73 20 73 6f 66 74 77  |ibute this softw|
00000990  61 72 65 20 20 20 20 20  20 20 20 20 20 2a 0a 2a  |are          *.*|
000009a0  20 20 20 20 20 20 20 20  20 69 66 2c 20 61 6e 64  |         if, and|
000009b0  20 6f 6e 6c 79 20 69 66  2c 20 79 6f 75 20 68 61  | only if, you ha|
000009c0  76 65 20 53 61 6e 6a 61  79 20 50 61 74 74 6e 69  |ve Sanjay Pattni|
000009d0  27 73 20 65 78 70 6c 69  63 69 74 20 70 65 72 6d  |'s explicit perm|
000009e0  69 73 73 69 6f 6e 20 20  20 20 20 20 20 20 2a 0a  |ission        *.|
000009f0  2a 20 20 20 20 20 20 20  20 20 74 6f 20 64 69 73  |*         to dis|
00000a00  74 72 69 62 75 74 65 20  74 68 69 73 20 73 6f 66  |tribute this sof|
00000a10  74 77 61 72 65 2e 20 20  20 20 20 20 20 20 20 20  |tware.          |
00000a20  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000a30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 2a  |               *|
00000a40  0a 2a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.*              |
00000a50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000a90  2a 0a 2a 20 20 20 20 20  28 34 29 20 41 6c 6c 20  |*.*     (4) All |
00000aa0  63 6f 70 69 65 73 20 61  6e 64 20 69 6e 73 74 61  |copies and insta|
00000ab0  6c 6c 61 74 69 6f 6e 73  20 6f 66 20 74 68 69 73  |llations of this|
00000ac0  20 73 6f 66 74 77 61 72  65 20 63 6f 6e 74 61 69  | software contai|
00000ad0  6e 20 74 68 69 73 20 20  20 20 20 20 20 20 20 20  |n this          |
00000ae0  20 2a 0a 2a 20 20 20 20  20 20 20 20 20 66 69 6c  | *.*         fil|
00000af0  65 20 28 75 6e 65 64 69  74 65 64 29 2e 20 20 20  |e (unedited).   |
00000b00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000b30  20 20 2a 0a 2a 20 20 20  20 20 20 20 20 20 20 20  |  *.*           |
00000b40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000b80  20 20 20 2a 0a 2a 20 20  20 20 20 28 35 29 20 4f  |   *.*     (5) O|
00000b90  77 6e 65 72 73 68 69 70  20 6f 66 20 74 68 69 73  |wnership of this|
00000ba0  20 73 6f 66 74 77 61 72  65 20 72 65 6d 61 69 6e  | software remain|
00000bb0  73 20 77 69 74 68 20 53  61 6e 6a 61 79 20 50 61  |s with Sanjay Pa|
00000bc0  74 74 6e 69 20 61 74 20  61 6c 6c 20 20 20 20 20  |ttni at all     |
00000bd0  20 20 20 20 2a 0a 2a 20  20 20 20 20 20 20 20 20  |    *.*         |
00000be0  74 69 6d 65 73 2e 20 20  20 20 20 20 20 20 20 20  |times.          |
00000bf0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000c20  20 20 20 20 20 2a 0a 2a  20 20 20 20 20 20 20 20  |     *.*        |
00000c30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000c70  20 20 20 20 20 20 2a 0a  2a 20 20 20 20 20 28 36  |      *.*     (6|
00000c80  29 20 54 68 69 73 20 73  6f 66 74 77 61 72 65 20  |) This software |
00000c90  69 73 20 70 72 6f 76 69  64 65 64 20 77 69 74 68  |is provided with|
00000ca0  20 6e 6f 20 65 78 70 6c  69 63 69 74 20 6e 6f 72  | no explicit nor|
00000cb0  20 69 6d 70 6c 69 63 69  74 20 20 20 20 20 20 20  | implicit       |
00000cc0  20 20 20 20 20 20 20 2a  0a 2a 20 20 20 20 20 20  |       *.*      |
00000cd0  20 20 20 77 61 72 72 61  6e 74 79 2e 20 53 61 6e  |   warranty. San|
00000ce0  6a 61 79 20 50 61 74 74  6e 69 20 64 6f 65 73 20  |jay Pattni does |
00000cf0  6e 6f 74 20 72 65 63 6f  6d 6d 65 6e 64 20 69 74  |not recommend it|
00000d00  73 20 66 69 74 6e 65 73  73 20 66 6f 72 20 20 20  |s fitness for   |
00000d10  20 20 20 20 20 20 20 20  2a 0a 2a 20 20 20 20 20  |        *.*     |
00000d20  20 20 20 20 66 6f 72 20  61 6e 79 20 70 75 72 70  |    for any purp|
00000d30  6f 73 65 2e 20 20 20 20  20 20 20 20 20 20 20 20  |ose.            |
00000d40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000d60  20 20 20 20 20 20 20 20  20 2a 0a 2a 20 20 20 20  |         *.*    |
00000d70  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000db0  20 20 20 20 20 20 20 20  20 20 2a 0a 2a 20 20 20  |          *.*   |
00000dc0  20 20 49 66 20 79 6f 75  20 64 6f 20 6e 6f 74 20  |  If you do not |
00000dd0  61 63 63 65 70 74 20 74  68 65 73 65 20 6c 69 63  |accept these lic|
00000de0  65 6e 63 65 20 63 6f 6e  64 69 74 69 6f 6e 73 2c  |ence conditions,|
00000df0  20 79 6f 75 20 6d 75 73  74 20 64 65 6c 65 74 65  | you must delete|
00000e00  20 61 6c 6c 20 20 20 20  20 20 20 2a 0a 2a 20 20  | all       *.*  |
00000e10  20 20 20 79 6f 75 72 20  63 6f 70 69 65 73 20 6f  |   your copies o|
00000e20  66 20 74 68 69 73 20 73  6f 66 74 77 61 72 65 2e  |f this software.|
00000e30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000e50  20 20 20 20 20 20 20 20  20 20 20 20 2a 0a 2a 20  |            *.* |
00000e60  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000ea0  20 20 20 20 20 20 20 20  20 20 20 20 20 2a 0a 2a  |             *.*|
00000eb0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000ef0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 0a  |***************.|
00000f00  0a 0a 20 20 41 62 73 74  72 61 63 74 3a 0a 20 20  |..  Abstract:.  |
00000f10  3d 3d 3d 3d 3d 3d 3d 3d  3d 0a 20 20 20 20 46 69  |=========.    Fi|
00000f20  6c 65 4d 61 74 63 68 20  69 73 20 61 6e 20 69 6e  |leMatch is an in|
00000f30  74 65 6c 6c 69 67 65 6e  74 20 66 69 6c 65 20 66  |telligent file f|
00000f40  69 6e 64 69 6e 67 20 75  74 69 6c 69 74 79 2e 20  |inding utility. |
00000f50  49 74 20 77 69 6c 6c 20  73 65 61 72 63 68 20 61  |It will search a|
00000f60  0a 20 20 20 20 64 69 72  65 63 74 6f 72 79 20 61  |.    directory a|
00000f70  6e 64 20 74 72 79 20 74  6f 20 6d 61 74 63 68 20  |nd try to match |
00000f80  66 69 6c 65 20 63 68 61  72 61 63 74 65 72 69 73  |file characteris|
00000f90  74 69 63 73 20 61 63 63  6f 72 64 69 6e 67 20 74  |tics according t|
00000fa0  6f 20 61 20 76 65 72 79  0a 20 20 20 20 65 78 74  |o a very.    ext|
00000fb0  65 6e 73 69 76 65 20 75  73 65 72 20 73 70 65 63  |ensive user spec|
00000fc0  69 66 69 65 64 20 74 65  6d 70 6c 61 74 65 2e 20  |ified template. |
00000fd0  54 68 65 20 75 74 69 6c  69 74 79 20 63 61 6e 20  |The utility can |
00000fe0  62 65 20 75 73 65 64 20  64 69 72 65 63 74 6c 79  |be used directly|
00000ff0  0a 20 20 20 20 66 72 6f  6d 20 74 68 65 20 63 6f  |.    from the co|
00001000  6d 6d 61 6e 64 20 6c 69  6e 65 20 6f 72 20 76 69  |mmand line or vi|
00001010  61 20 61 20 57 49 4d 50  20 66 72 6f 6e 74 20 65  |a a WIMP front e|
00001020  6e 64 2e 0a 0a 0a 20 20  52 65 71 75 69 72 65 6d  |nd....  Requirem|
00001030  65 6e 74 73 3a 0a 20 20  3d 3d 3d 3d 3d 3d 3d 3d  |ents:.  ========|
00001040  3d 3d 3d 3d 3d 0a 20 20  20 20 31 4d 42 79 74 65  |=====.    1MByte|
00001050  20 6f 72 20 6d 6f 72 65  20 6d 65 6d 6f 72 79 2e  | or more memory.|
00001060  0a 0a 20 20 20 20 52 69  73 63 20 4f 53 20 33 20  |..    Risc OS 3 |
00001070  6f 72 20 61 62 6f 76 65  2e 0a 0a 20 20 20 20 52  |or above...    R|
00001080  69 73 63 20 4f 53 20 70  72 69 6f 72 20 74 6f 20  |isc OS prior to |
00001090  33 2e 36 20 72 65 71 75  69 72 65 73 20 76 61 72  |3.6 requires var|
000010a0  69 6f 75 73 20 54 6f 6f  6c 62 6f 78 20 6d 6f 64  |ious Toolbox mod|
000010b0  75 6c 65 73 20 74 6f 20  62 65 20 73 6f 66 74 2d  |ules to be soft-|
000010c0  6c 6f 61 64 65 64 3a 0a  0a 20 20 20 20 20 20 20  |loaded:..       |
000010d0  20 54 6f 6f 6c 62 6f 78  20 20 20 20 20 31 2e 33  | Toolbox     1.3|
000010e0  36 0a 20 20 20 20 20 20  20 20 57 69 6e 64 6f 77  |6.        Window|
000010f0  20 20 20 20 20 20 31 2e  33 31 0a 20 20 20 20 20  |      1.31.     |
00001100  20 20 20 4d 65 6e 75 20  20 20 20 20 20 20 20 30  |   Menu        0|
00001110  2e 32 34 0a 20 20 20 20  20 20 20 20 49 63 6f 6e  |.24.        Icon|
00001120  62 61 72 20 20 20 20 20  31 2e 31 32 0a 20 20 20  |bar     1.12.   |
00001130  20 20 20 20 20 50 72 6f  67 49 6e 66 6f 20 20 20  |     ProgInfo   |
00001140  20 30 2e 30 39 0a 0a 20  20 20 20 4e 6f 74 65 20  | 0.09..    Note |
00001150  31 3a 20 54 68 65 79 20  61 72 65 20 6f 6e 6c 79  |1: They are only|
00001160  20 72 65 71 75 69 72 65  64 20 62 79 20 74 68 65  | required by the|
00001170  20 57 49 4d 50 20 62 61  73 65 64 20 66 72 6f 6e  | WIMP based fron|
00001180  74 20 65 6e 64 2c 20 69  65 2e 20 66 6f 72 20 70  |t end, ie. for p|
00001190  75 72 65 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ure.            |
000011a0  63 6f 6d 6d 61 6e 64 20  6c 69 6e 65 20 75 73 61  |command line usa|
000011b0  67 65 2c 20 74 68 65 79  20 61 72 65 20 6e 6f 74  |ge, they are not|
000011c0  20 6e 65 65 64 65 64 2e  0a 20 20 20 20 4e 6f 74  | needed..    Not|
000011d0  65 20 32 3a 20 54 68 65  79 20 61 72 65 20 6e 6f  |e 2: They are no|
000011e0  74 20 73 75 70 70 6c 69  65 64 20 77 69 74 68 20  |t supplied with |
000011f0  74 68 69 73 20 64 69 73  74 72 69 62 75 74 69 6f  |this distributio|
00001200  6e 2e 0a 0a 0a 0a 20 20  46 72 6f 6e 74 20 65 6e  |n.....  Front en|
00001210  64 3a 0a 20 20 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 0a  |d:.  ==========.|
00001220  20 20 20 20 52 75 6e 20  21 46 69 6c 65 4d 61 74  |    Run !FileMat|
00001230  63 68 20 66 6f 72 20 61  20 52 49 53 43 20 4f 53  |ch for a RISC OS|
00001240  20 63 6f 6d 70 6c 69 61  6e 74 20 66 72 6f 6e 74  | compliant front|
00001250  65 6e 64 20 74 6f 20 46  69 6c 65 4d 61 74 63 68  |end to FileMatch|
00001260  2e 0a 20 20 20 20 55 73  65 20 49 6e 74 65 72 61  |..    Use Intera|
00001270  63 74 69 76 65 20 48 65  6c 70 20 66 6f 72 20 69  |ctive Help for i|
00001280  6e 73 74 72 75 63 74 69  6f 6e 73 2e 0a 0a 0a 20  |nstructions.... |
00001290  20 43 6f 6d 6d 61 6e 64  20 4c 69 6e 65 20 53 79  | Command Line Sy|
000012a0  6e 74 61 78 3a 0a 20 20  3d 3d 3d 3d 3d 3d 3d 3d  |ntax:.  ========|
000012b0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 0a 20 20 20  |============.   |
000012c0  20 20 20 20 20 46 69 6c  65 4d 61 74 63 68 20 5b  |     FileMatch [|
000012d0  66 6c 61 67 20 6f 70 74  69 6f 6e 73 5d 5e 0a 0a  |flag options]^..|
000012e0  0a 20 20 46 6c 61 67 20  4f 70 74 69 6f 6e 73 3a  |.  Flag Options:|
000012f0  0a 20 20 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.  =============|
00001300  0a 20 20 20 20 28 44 65  66 61 75 6c 74 20 69 73  |.    (Default is|
00001310  20 73 68 6f 77 6e 20 69  6e 20 62 72 61 63 6b 65  | shown in bracke|
00001320  74 73 20 61 66 74 65 72  20 64 65 73 63 72 69 70  |ts after descrip|
00001330  74 69 6f 6e 29 0a 0a 20  20 20 20 2d 61 20 3c 41  |tion)..    -a <A|
00001340  63 63 65 73 73 20 73 74  72 69 6e 67 3e 0a 20 20  |ccess string>.  |
00001350  20 20 20 20 20 20 3c 41  63 63 65 73 73 20 73 74  |      <Access st|
00001360  72 69 6e 67 3e 20 69 73  20 61 20 73 74 72 69 6e  |ring> is a strin|
00001370  67 20 73 70 65 63 69 66  79 69 6e 67 20 77 68 61  |g specifying wha|
00001380  74 20 61 63 63 65 73 73  20 61 74 74 72 69 62 75  |t access attribu|
00001390  74 65 73 0a 20 20 20 20  20 20 20 20 73 68 6f 75  |tes.        shou|
000013a0  6c 64 20 62 65 20 6d 61  74 63 68 65 64 2e 20 54  |ld be matched. T|
000013b0  68 65 20 66 6f 72 6d 61  74 20 69 73 20 73 6f 6d  |he format is som|
000013c0  65 74 68 69 6e 67 20 6c  69 6b 65 3a 0a 20 20 20  |ething like:.   |
000013d0  20 20 20 20 20 20 20 20  20 22 50 6c 77 52 2f 77  |         "PlwR/w|
000013e0  52 22 0a 20 20 20 20 20  20 20 20 54 68 65 20 63  |R".        The c|
000013f0  68 61 72 61 63 74 65 72  73 20 74 6f 20 74 68 65  |haracters to the|
00001400  20 6c 65 66 74 20 6f 66  20 74 68 65 20 22 2f 22  | left of the "/"|
00001410  20 61 72 65 20 6f 77 6e  65 72 20 61 63 63 65 73  | are owner acces|
00001420  73 20 61 74 74 72 69 62  75 74 65 73 2e 0a 20 20  |s attributes..  |
00001430  20 20 20 20 20 20 54 68  65 20 63 68 61 72 61 63  |      The charac|
00001440  74 65 72 73 20 74 6f 20  74 68 65 20 72 69 67 68  |ters to the righ|
00001450  74 20 6f 66 20 74 68 65  20 22 2f 22 20 61 72 65  |t of the "/" are|
00001460  20 70 75 62 6c 69 63 20  61 63 63 65 73 73 20 61  | public access a|
00001470  74 74 72 69 62 75 74 65  73 2e 0a 20 20 20 20 20  |ttributes..     |
00001480  20 20 20 41 6e 20 75 70  70 65 72 2d 63 61 73 65  |   An upper-case|
00001490  20 6c 65 74 74 65 72 20  73 70 65 63 69 66 69 65  | letter specifie|
000014a0  73 20 74 68 61 74 20 74  68 65 20 61 74 74 72 69  |s that the attri|
000014b0  62 75 74 65 20 69 73 20  4f 4e 2e 20 41 20 6c 6f  |bute is ON. A lo|
000014c0  77 65 72 2d 63 61 73 65  0a 20 20 20 20 20 20 20  |wer-case.       |
000014d0  20 6c 65 74 74 65 72 20  73 70 65 63 69 66 69 65  | letter specifie|
000014e0  73 20 74 68 61 74 20 74  68 65 20 61 74 74 72 69  |s that the attri|
000014f0  62 75 74 65 20 69 73 20  4f 46 46 2e 20 49 66 20  |bute is OFF. If |
00001500  74 68 65 20 61 74 74 72  69 62 75 74 65 20 69 73  |the attribute is|
00001510  20 6e 6f 74 0a 20 20 20  20 20 20 20 20 70 72 65  | not.        pre|
00001520  73 65 6e 74 2c 20 69 74  27 73 20 73 74 61 74 65  |sent, it's state|
00001530  20 77 69 6c 6c 20 6e 6f  74 20 62 65 20 6d 61 74  | will not be mat|
00001540  63 68 65 64 2e 0a 20 20  20 20 20 20 20 20 20 20  |ched..          |
00001550  20 20 22 50 22 20 3d 20  50 72 69 76 61 74 69 73  |  "P" = Privatis|
00001560  65 64 20 2d 20 75 73 65  64 20 6f 6e 20 53 4a 20  |ed - used on SJ |
00001570  52 65 73 65 61 72 63 68  20 4d 44 46 53 20 6e 65  |Research MDFS ne|
00001580  74 77 6f 72 6b 73 0a 20  20 20 20 20 20 20 20 20  |tworks.         |
00001590  20 20 20 22 4c 22 20 3d  20 4c 6f 63 6b 65 64 0a  |   "L" = Locked.|
000015a0  20 20 20 20 20 20 20 20  20 20 20 20 22 57 22 20  |            "W" |
000015b0  3d 20 57 72 69 74 65 20  41 63 63 65 73 73 0a 20  |= Write Access. |
000015c0  20 20 20 20 20 20 20 20  20 20 20 22 52 22 20 3d  |           "R" =|
000015d0  20 52 65 61 64 20 41 63  63 65 73 73 0a 0a 20 20  | Read Access..  |
000015e0  20 20 2d 63 73 0a 20 20  20 20 20 20 20 20 4d 61  |  -cs.        Ma|
000015f0  6b 65 20 74 68 65 20 77  69 6c 64 20 63 61 72 64  |ke the wild card|
00001600  20 73 65 61 72 63 68 20  6e 61 6d 65 20 63 61 73  | search name cas|
00001610  65 20 73 65 6e 73 69 74  69 76 65 2e 20 28 64 65  |e sensitive. (de|
00001620  66 61 75 6c 74 3d 4f 46  46 29 0a 0a 20 20 20 20  |fault=OFF)..    |
00001630  2d 64 20 3c 20 3c 6d 69  6e 20 74 69 6d 65 5b 20  |-d < <min time[ |
00001640  3c 6d 61 78 20 74 69 6d  65 3e 5d 3e 20 7c 20 3c  |<max time>]> | <|
00001650  72 65 6c 61 74 69 76 65  20 74 69 6d 65 20 73 74  |relative time st|
00001660  72 69 6e 67 3e 20 3e 0a  20 20 20 20 20 20 20 20  |ring> >.        |
00001670  4d 61 74 63 68 20 64 61  74 65 20 73 74 61 6d 70  |Match date stamp|
00001680  20 6f 72 20 64 61 74 65  20 73 74 61 6d 70 20 72  | or date stamp r|
00001690  61 6e 67 65 20 6f 72 20  72 65 6c 61 74 69 76 65  |ange or relative|
000016a0  20 74 69 6d 65 20 72 61  6e 67 65 2e 0a 20 20 20  | time range..   |
000016b0  20 20 20 20 20 46 6f 72  6d 61 74 20 6f 66 20 3c  |     Format of <|
000016c0  6d 69 6e 2f 6d 61 78 20  74 69 6d 65 3e 20 69 73  |min/max time> is|
000016d0  20 66 69 76 65 20 62 79  74 65 73 20 6f 66 20 68  | five bytes of h|
000016e0  65 78 2c 20 65 67 2e 20  22 31 61 32 62 33 63 34  |ex, eg. "1a2b3c4|
000016f0  64 35 65 22 0a 20 20 20  20 20 20 20 20 77 68 65  |d5e".        whe|
00001700  72 65 20 74 68 65 20 6d  6f 73 74 20 73 69 67 6e  |re the most sign|
00001710  69 66 69 63 61 6e 74 20  62 79 74 65 20 69 73 20  |ificant byte is |
00001720  67 69 76 65 6e 20 66 69  72 73 74 2e 0a 0a 20 20  |given first...  |
00001730  20 20 20 20 20 20 41 20  72 65 6c 61 74 69 76 65  |      A relative|
00001740  20 74 69 6d 65 20 73 74  72 69 6e 67 20 69 73 20  | time string is |
00001750  75 73 65 64 20 74 6f 20  73 70 65 63 69 66 79 20  |used to specify |
00001760  61 20 74 69 6d 65 20 72  61 6e 67 65 20 72 65 6c  |a time range rel|
00001770  61 74 69 76 65 20 74 6f  0a 20 20 20 20 20 20 20  |ative to.       |
00001780  20 74 68 65 20 63 75 72  72 65 6e 74 20 74 69 6d  | the current tim|
00001790  65 2c 20 65 67 2e 20 22  74 68 69 73 64 61 79 22  |e, eg. "thisday"|
000017a0  2e 0a 0a 20 20 20 20 20  20 20 20 54 68 65 72 65  |...        There|
000017b0  20 61 72 65 20 35 20 73  75 66 66 69 78 65 73 2c  | are 5 suffixes,|
000017c0  20 69 65 2e 20 74 69 6d  65 20 75 6e 69 74 73 3a  | ie. time units:|
000017d0  0a 20 20 20 20 20 20 20  20 20 20 20 20 22 68 6f  |.            "ho|
000017e0  75 72 22 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ur".            |
000017f0  22 64 61 79 22 0a 20 20  20 20 20 20 20 20 20 20  |"day".          |
00001800  20 20 22 77 65 65 6b 22  20 20 20 20 20 20 4d 79  |  "week"      My|
00001810  20 77 65 65 6b 73 20 73  74 61 72 74 20 6f 6e 20  | weeks start on |
00001820  61 20 4d 6f 6e 64 61 79  21 0a 20 20 20 20 20 20  |a Monday!.      |
00001830  20 20 20 20 20 20 22 6d  6f 6e 74 68 22 0a 20 20  |      "month".  |
00001840  20 20 20 20 20 20 20 20  20 20 22 79 65 61 72 22  |          "year"|
00001850  0a 0a 20 20 20 20 20 20  20 20 54 68 65 72 65 20  |..        There |
00001860  61 72 65 20 33 20 70 72  65 66 69 78 65 73 3a 0a  |are 3 prefixes:.|
00001870  20 20 20 20 20 20 20 20  20 20 20 20 22 74 68 69  |            "thi|
00001880  73 22 20 3d 20 74 68 65  20 63 75 72 72 65 6e 74  |s" = the current|
00001890  20 74 69 6d 65 20 75 6e  69 74 0a 20 20 20 20 20  | time unit.     |
000018a0  20 20 20 20 20 20 20 22  6c 61 73 74 22 20 3d 20  |       "last" = |
000018b0  74 68 65 20 70 72 65 76  69 6f 75 73 20 74 69 6d  |the previous tim|
000018c0  65 20 75 6e 69 74 0a 20  20 20 20 20 20 20 20 20  |e unit.         |
000018d0  20 20 20 22 70 61 73 74  22 20 3d 20 63 75 72 72  |   "past" = curr|
000018e0  65 6e 74 20 74 69 6d 65  20 2d 20 6f 6e 65 20 74  |ent time - one t|
000018f0  69 6d 65 20 75 6e 69 74  0a 20 20 20 20 20 20 20  |ime unit.       |
00001900  20 65 67 2e 20 74 68 65  20 63 75 72 72 65 6e 74  | eg. the current|
00001910  20 74 69 6d 65 20 69 73  20 31 37 3a 34 37 0a 20  | time is 17:47. |
00001920  20 20 20 20 20 20 20 20  20 20 20 22 74 68 69 73  |           "this|
00001930  68 6f 75 72 22 20 3d 20  31 37 3a 30 30 3a 30 30  |hour" = 17:00:00|
00001940  2e 30 30 20 2d 3e 20 31  37 3a 35 39 3a 35 39 2e  |.00 -> 17:59:59.|
00001950  35 39 0a 20 20 20 20 20  20 20 20 20 20 20 20 22  |59.            "|
00001960  6c 61 73 74 68 6f 75 72  22 20 3d 20 31 36 3a 30  |lasthour" = 16:0|
00001970  30 3a 30 30 2e 30 30 20  2d 3e 20 31 36 3a 35 39  |0:00.00 -> 16:59|
00001980  3a 35 39 2e 35 39 0a 20  20 20 20 20 20 20 20 20  |:59.59.         |
00001990  20 20 20 22 70 61 73 74  68 6f 75 72 22 20 3d 20  |   "pasthour" = |
000019a0  31 36 3a 34 37 3a 30 30  2e 30 30 20 2d 3e 20 31  |16:47:00.00 -> 1|
000019b0  37 3a 34 36 3a 35 39 2e  35 39 0a 0a 20 20 20 20  |7:46:59.59..    |
000019c0  2d 65 20 3c 6d 69 6e 20  61 64 64 72 65 73 73 3e  |-e <min address>|
000019d0  5b 20 3c 6d 61 78 20 61  64 64 72 65 73 73 3e 5d  |[ <max address>]|
000019e0  0a 20 20 20 20 20 20 20  20 4d 61 74 63 68 20 65  |.        Match e|
000019f0  78 65 63 75 74 69 6f 6e  20 61 64 64 72 65 73 73  |xecution address|
00001a00  2e 20 53 65 65 20 6e 6f  74 65 20 5b 31 5d 2c 20  |. See note [1], |
00001a10  5b 32 5d 2e 0a 0a 20 20  20 20 2d 6c 20 3c 6d 69  |[2]...    -l <mi|
00001a20  6e 20 61 64 64 72 65 73  73 3e 5b 20 3c 6d 61 78  |n address>[ <max|
00001a30  20 61 64 64 72 65 73 73  3e 5d 0a 20 20 20 20 20  | address>].     |
00001a40  20 20 20 4d 61 74 63 68  20 6c 6f 61 64 20 61 64  |   Match load ad|
00001a50  64 72 65 73 73 2e 20 53  65 65 20 6e 6f 74 65 20  |dress. See note |
00001a60  5b 31 5d 2c 20 5b 32 5d  2e 0a 0a 20 20 20 20 2d  |[1], [2]...    -|
00001a70  6d 20 3c 66 69 6c 65 3e  0a 20 20 20 20 20 20 20  |m <file>.       |
00001a80  20 3c 66 69 6c 65 3e 20  73 70 65 63 69 66 69 65  | <file> specifie|
00001a90  73 20 61 20 66 69 6c 65  20 77 68 69 63 68 20 69  |s a file which i|
00001aa0  73 20 74 6f 20 75 73 65  64 20 61 73 20 61 20 74  |s to used as a t|
00001ab0  65 6d 70 6c 61 74 65 2e  20 4e 6f 74 65 20 74 68  |emplate. Note th|
00001ac0  61 74 0a 20 20 20 20 20  20 20 20 74 68 69 73 20  |at.        this |
00001ad0  77 69 6c 6c 20 6f 76 65  72 72 69 64 65 20 61 6e  |will override an|
00001ae0  79 20 70 72 65 63 65 64  69 6e 67 20 6d 61 74 63  |y preceding matc|
00001af0  68 20 70 61 72 61 6d 65  74 65 72 73 2e 0a 0a 20  |h parameters... |
00001b00  20 20 20 2d 6e 20 3c 77  69 6c 64 63 61 72 64 65  |   -n <wildcarde|
00001b10  64 20 6e 61 6d 65 3e 0a  20 20 20 20 20 20 20 20  |d name>.        |
00001b20  3c 77 69 6c 64 63 61 72  64 65 64 20 6e 61 6d 65  |<wildcarded name|
00001b30  3e 20 73 70 65 63 69 66  69 65 73 20 61 20 77 69  |> specifies a wi|
00001b40  6c 64 63 61 72 64 65 64  20 6e 61 6d 65 20 74 6f  |ldcarded name to|
00001b50  20 6d 61 74 63 68 20 28  64 65 66 61 75 6c 74 3d  | match (default=|
00001b60  22 2a 22 29 0a 20 20 20  20 20 20 20 20 22 23 22  |"*").        "#"|
00001b70  20 3d 20 6d 61 74 63 68  65 73 20 61 6e 79 20 73  | = matches any s|
00001b80  69 6e 67 6c 65 20 63 68  61 72 61 63 74 65 72 0a  |ingle character.|
00001b90  20 20 20 20 20 20 20 20  22 2a 22 20 3d 20 6d 61  |        "*" = ma|
00001ba0  74 63 68 65 73 20 30 20  6f 72 20 6d 6f 72 65 20  |tches 0 or more |
00001bb0  63 68 61 72 61 63 74 65  72 73 0a 0a 20 20 20 20  |characters..    |
00001bc0  2d 6f 20 3c 76 61 6c 75  65 3e 0a 20 20 20 20 20  |-o <value>.     |
00001bd0  20 20 20 4f 75 74 70 75  74 3a 20 28 44 65 66 61  |   Output: (Defa|
00001be0  75 6c 74 20 3d 20 4f 75  74 70 75 74 20 6e 6f 74  |ult = Output not|
00001bf0  68 69 6e 67 29 0a 20 20  20 20 20 20 20 20 42 69  |hing).        Bi|
00001c00  74 20 31 20 3d 20 46 69  6c 65 6e 61 6d 65 0a 20  |t 1 = Filename. |
00001c10  20 20 20 20 20 20 20 42  69 74 20 32 20 3d 20 46  |       Bit 2 = F|
00001c20  69 6c 65 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 0a  |ile information.|
00001c30  0a 20 20 20 20 2d 6f 74  20 3c 6f 62 6a 65 63 74  |.    -ot <object|
00001c40  20 74 79 70 65 73 3e 0a  20 20 20 20 20 20 20 20  | types>.        |
00001c50  3c 6f 62 6a 65 63 74 20  74 79 70 65 73 3e 20 69  |<object types> i|
00001c60  73 20 69 6e 74 65 67 65  72 20 73 70 65 63 69 66  |s integer specif|
00001c70  79 69 6e 67 20 6f 62 6a  65 63 74 73 20 74 6f 20  |ying objects to |
00001c80  6d 61 74 63 68 20 28 64  65 66 61 75 6c 74 3d 31  |match (default=1|
00001c90  29 0a 20 20 20 20 20 20  20 20 42 69 74 20 30 20  |).        Bit 0 |
00001ca0  3d 20 46 69 6c 65 73 0a  20 20 20 20 20 20 20 20  |= Files.        |
00001cb0  42 69 74 20 31 20 3d 20  44 69 72 65 63 74 6f 72  |Bit 1 = Director|
00001cc0  69 65 73 0a 20 20 20 20  20 20 20 20 42 69 74 20  |ies.        Bit |
00001cd0  32 20 3d 20 49 6d 61 67  65 20 46 69 6c 65 73 0a  |2 = Image Files.|
00001ce0  0a 20 20 20 20 2d 70 20  3c 70 61 74 68 3e 0a 20  |.    -p <path>. |
00001cf0  20 20 20 20 20 20 20 3c  70 61 74 68 3e 20 73 70  |       <path> sp|
00001d00  65 63 69 66 69 65 73 20  64 69 72 65 63 74 6f 72  |ecifies director|
00001d10  79 20 74 6f 20 73 74 61  72 74 20 73 65 61 72 63  |y to start searc|
00001d20  68 20 66 72 6f 6d 2e 20  28 64 65 66 61 75 6c 74  |h from. (default|
00001d30  3d 43 53 44 29 0a 0a 20  20 20 20 2d 72 0a 20 20  |=CSD)..    -r.  |
00001d40  20 20 20 20 20 20 52 65  63 75 72 73 69 76 65 6c  |      Recursivel|
00001d50  79 20 73 65 61 72 63 68  20 64 69 72 65 63 74 6f  |y search directo|
00001d60  72 69 65 73 20 28 44 65  66 61 75 6c 74 20 3d 20  |ries (Default = |
00001d70  4f 46 46 29 0a 0a 20 20  20 20 2d 72 69 0a 20 20  |OFF)..    -ri.  |
00001d80  20 20 20 20 20 20 52 65  63 75 72 73 69 76 65 6c  |      Recursivel|
00001d90  79 20 73 65 61 72 63 68  20 69 6d 61 67 65 20 66  |y search image f|
00001da0  69 6c 65 73 20 28 44 65  66 61 75 6c 74 20 3d 20  |iles (Default = |
00001db0  4f 46 46 29 0a 0a 20 20  20 20 2d 73 20 3c 6d 69  |OFF)..    -s <mi|
00001dc0  6e 20 73 69 7a 65 3e 5b  20 3c 6d 61 78 20 73 69  |n size>[ <max si|
00001dd0  7a 65 3e 5d 0a 20 20 20  20 20 20 20 20 4d 61 74  |ze>].        Mat|
00001de0  63 68 20 66 69 6c 65 73  20 6f 66 20 67 69 76 65  |ch files of give|
00001df0  6e 20 73 69 7a 65 20 6f  72 20 73 69 7a 65 20 72  |n size or size r|
00001e00  61 6e 67 65 2e 20 53 65  65 20 6e 6f 74 65 20 5b  |ange. See note [|
00001e10  31 5d 2c 20 5b 32 5d 2e  0a 0a 20 20 20 20 2d 74  |1], [2]...    -t|
00001e20  20 3c 66 69 6c 65 74 79  70 65 20 73 74 72 69 6e  | <filetype strin|
00001e30  67 3e 0a 20 20 20 20 20  20 20 20 3c 66 69 6c 65  |g>.        <file|
00001e40  74 79 70 65 20 73 74 72  69 6e 67 3e 20 69 73 20  |type string> is |
00001e50  66 69 6c 65 74 79 70 65  20 74 6f 20 6d 61 74 63  |filetype to matc|
00001e60  68 0a 0a 20 20 20 20 2d  76 0a 20 20 20 20 20 20  |h..    -v.      |
00001e70  20 20 56 65 72 62 6f 73  65 20 28 44 65 66 61 75  |  Verbose (Defau|
00001e80  6c 74 20 3d 20 4f 46 46  29 0a 0a 20 20 20 20 2d  |lt = OFF)..    -|
00001e90  78 20 22 3c 63 6f 6d 6d  61 6e 64 3e 22 0a 20 20  |x "<command>".  |
00001ea0  20 20 20 20 20 20 43 6f  6d 6d 61 6e 64 20 74 6f  |      Command to|
00001eb0  20 65 58 65 63 75 74 65  20 6f 6e 20 6d 61 74 63  | eXecute on matc|
00001ec0  68 65 64 20 66 69 6c 65  73 20 2d 20 76 65 72 79  |hed files - very|
00001ed0  20 75 73 65 66 75 6c 20  61 6e 64 20 61 6c 73 6f  | useful and also|
00001ee0  20 76 65 72 79 0a 20 20  20 20 20 20 20 20 64 61  | very.        da|
00001ef0  6e 67 65 72 6f 75 73 20  69 66 20 61 62 75 73 65  |ngerous if abuse|
00001f00  64 2e 0a 0a 20 20 20 20  20 20 20 20 43 6f 6d 6d  |d...        Comm|
00001f10  61 6e 64 20 4d 61 63 72  6f 73 3a 0a 20 20 20 20  |and Macros:.    |
00001f20  20 20 20 20 20 20 22 5c  70 22 20 3d 20 50 61 74  |      "\p" = Pat|
00001f30  68 20 6f 66 20 66 69 6c  65 2c 0a 20 20 20 20 20  |h of file,.     |
00001f40  20 20 20 20 20 22 5c 6e  22 20 3d 20 4e 61 6d 65  |     "\n" = Name|
00001f50  20 6f 66 20 66 69 6c 65  2c 0a 20 20 20 20 20 20  | of file,.      |
00001f60  20 20 20 20 22 5c 5c 22  20 3d 20 73 69 6e 67 6c  |    "\\" = singl|
00001f70  65 20 22 5c 22 0a 0a 0a  20 20 45 78 61 6d 70 6c  |e "\"...  Exampl|
00001f80  65 73 3a 0a 20 20 3d 3d  3d 3d 3d 3d 3d 3d 3d 0a  |es:.  =========.|
00001f90  20 20 2a 20 4c 69 73 74  20 61 6c 6c 20 66 69 6c  |  * List all fil|
00001fa0  65 73 20 77 69 74 68 20  64 61 74 65 20 73 74 61  |es with date sta|
00001fb0  6d 70 20 6f 66 20 73 6f  6d 65 74 69 6d 65 20 74  |mp of sometime t|
00001fc0  6f 64 61 79 20 66 72 6f  6d 20 43 53 44 20 61 6e  |oday from CSD an|
00001fd0  64 20 62 65 6c 6f 77 3a  0a 0a 20 20 20 20 20 20  |d below:..      |
00001fe0  46 69 6c 65 4d 61 74 63  68 20 2d 6f 20 31 20 2d  |FileMatch -o 1 -|
00001ff0  64 20 74 68 69 73 64 61  79 20 2d 72 20 2d 72 69  |d thisday -r -ri|
00002000  0a 0a 20 20 2a 20 4c 69  73 74 20 61 6c 6c 20 66  |..  * List all f|
00002010  69 6c 65 73 20 61 6e 64  20 69 6e 66 6f 20 6f 6e  |iles and info on|
00002020  20 74 68 65 6d 20 66 6f  72 20 66 69 6c 65 73 20  | them for files |
00002030  77 69 74 68 20 73 69 7a  65 20 6f 66 20 32 34 35  |with size of 245|
00002040  37 20 62 79 74 65 73 0a  20 20 20 20 65 78 61 63  |7 bytes.    exac|
00002050  74 6c 79 2c 20 69 6e 20  74 68 65 20 43 53 44 3a  |tly, in the CSD:|
00002060  0a 0a 20 20 20 20 20 20  46 69 6c 65 4d 61 74 63  |..      FileMatc|
00002070  68 20 2d 6f 20 33 20 2d  73 20 32 34 35 37 0a 0a  |h -o 3 -s 2457..|
00002080  20 20 2a 20 4c 69 73 74  20 61 6c 6c 20 66 69 6c  |  * List all fil|
00002090  65 73 20 77 69 74 68 20  73 69 7a 65 20 69 6e 20  |es with size in |
000020a0  74 68 65 20 72 61 6e 67  65 20 32 34 35 37 20 2b  |the range 2457 +|
000020b0  2f 2d 20 31 30 30 20 62  79 74 65 73 2c 20 69 6e  |/- 100 bytes, in|
000020c0  20 74 68 65 20 43 53 44  3a 0a 0a 20 20 20 20 20  | the CSD:..     |
000020d0  20 46 69 6c 65 4d 61 74  63 68 20 2d 6f 20 31 20  | FileMatch -o 1 |
000020e0  2d 73 20 32 34 35 37 20  2b 2b 31 30 30 0a 0a 20  |-s 2457 ++100.. |
000020f0  20 2a 20 4c 69 73 74 20  61 6c 6c 20 66 69 6c 65  | * List all file|
00002100  73 20 77 69 74 68 20 6c  6f 61 64 20 61 64 64 72  |s with load addr|
00002110  65 73 73 20 69 6e 20 74  68 65 20 72 61 6e 67 65  |ess in the range|
00002120  20 26 33 30 30 30 20 74  6f 20 26 37 66 66 66 0a  | &3000 to &7fff.|
00002130  20 20 20 20 69 6e 63 6c  75 73 69 76 65 2c 20 69  |    inclusive, i|
00002140  6e 20 74 68 65 20 43 53  44 3a 0a 0a 20 20 20 20  |n the CSD:..    |
00002150  20 20 46 69 6c 65 4d 61  74 63 68 20 2d 6f 20 31  |  FileMatch -o 1|
00002160  20 2d 6c 20 26 33 30 30  30 20 26 37 66 66 66 0a  | -l &3000 &7fff.|
00002170  0a 0a 20 20 4e 6f 74 65  73 3a 0a 20 20 3d 3d 3d  |..  Notes:.  ===|
00002180  3d 3d 3d 0a 20 20 5b 31  5d 20 46 6f 72 20 66 6c  |===.  [1] For fl|
00002190  61 67 73 20 77 68 69 63  68 20 61 6c 6c 6f 77 20  |ags which allow |
000021a0  61 20 73 69 6e 67 6c 65  20 76 61 6c 75 65 20 6f  |a single value o|
000021b0  72 20 61 20 72 61 6e 67  65 2c 20 69 66 20 61 20  |r a range, if a |
000021c0  73 69 6e 67 6c 65 20 76  61 6c 75 65 0a 20 20 20  |single value.   |
000021d0  20 20 20 69 73 20 67 69  76 65 6e 20 74 68 65 6e  |   is given then|
000021e0  20 61 20 6d 61 74 63 68  20 77 69 6c 6c 20 6f 6e  | a match will on|
000021f0  6c 79 20 6f 63 63 75 72  20 69 66 20 74 68 65 20  |ly occur if the |
00002200  66 69 6c 65 20 68 61 73  20 65 78 61 63 74 6c 79  |file has exactly|
00002210  20 74 68 69 73 0a 20 20  20 20 20 20 76 61 6c 75  | this.      valu|
00002220  65 2e 20 46 6f 72 20 61  20 72 61 6e 67 65 2c 20  |e. For a range, |
00002230  61 20 6d 61 74 63 68 20  77 69 6c 6c 20 6f 6e 6c  |a match will onl|
00002240  79 20 6f 63 63 75 72 20  69 66 20 74 68 65 20 66  |y occur if the f|
00002250  69 6c 65 20 68 61 73 20  61 20 76 61 6c 75 65 0a  |ile has a value.|
00002260  20 20 20 20 20 20 69 6e  20 74 68 65 20 5f 69 6e  |      in the _in|
00002270  63 6c 75 73 69 76 65 5f  20 72 61 6e 67 65 20 67  |clusive_ range g|
00002280  69 76 65 6e 20 62 79 20  6d 69 6e 20 61 6e 64 20  |iven by min and |
00002290  6d 61 78 2e 0a 0a 20 20  5b 32 5d 20 49 66 20 61  |max...  [2] If a|
000022a0  6e 20 69 6e 74 65 67 65  72 20 69 73 20 65 78 70  |n integer is exp|
000022b0  65 63 74 65 64 20 66 6f  72 20 61 20 66 6c 61 67  |ected for a flag|
000022c0  20 73 75 63 68 20 61 20  64 65 73 63 72 69 62 65  | such a describe|
000022d0  64 20 69 6e 20 5b 31 5d  2c 20 79 6f 75 0a 20 20  |d in [1], you.  |
000022e0  20 20 20 20 6d 61 79 20  70 72 65 66 69 78 20 74  |    may prefix t|
000022f0  68 65 20 22 6d 61 78 22  20 76 61 6c 75 65 20 77  |he "max" value w|
00002300  69 74 68 20 74 68 65 20  66 6f 6c 6c 6f 77 69 6e  |ith the followin|
00002310  67 20 6d 6f 64 69 66 69  65 72 73 3a 0a 20 20 20  |g modifiers:.   |
00002320  20 20 20 20 20 22 2b 22  20 20 3a 20 72 61 6e 67  |     "+"  : rang|
00002330  65 5f 6d 61 78 20 3d 20  66 69 72 73 74 20 70 61  |e_max = first pa|
00002340  72 61 6d 65 74 65 72 20  2b 20 73 65 63 6f 6e 64  |rameter + second|
00002350  20 70 61 72 61 6d 65 74  65 72 0a 20 20 20 20 20  | parameter.     |
00002360  20 20 20 22 2b 2d 22 20  3a 20 72 61 6e 67 65 5f  |   "+-" : range_|
00002370  6d 61 78 20 3d 20 66 69  72 73 74 20 70 61 72 61  |max = first para|
00002380  6d 65 74 65 72 20 2d 20  73 65 63 6f 6e 64 20 70  |meter - second p|
00002390  61 72 61 6d 65 74 65 72  0a 20 20 20 20 20 20 20  |arameter.       |
000023a0  20 22 2b 2b 22 20 3a 20  72 61 6e 67 65 5f 6d 69  | "++" : range_mi|
000023b0  6e 20 3d 20 66 69 72 73  74 20 70 61 72 61 6d 65  |n = first parame|
000023c0  74 65 72 20 2d 20 73 65  63 6f 6e 64 20 70 61 72  |ter - second par|
000023d0  61 6d 65 74 65 72 20 26  0a 20 20 20 20 20 20 20  |ameter &.       |
000023e0  20 20 20 20 20 20 20 20  72 61 6e 67 65 5f 6d 61  |        range_ma|
000023f0  78 20 3d 20 66 69 72 73  74 20 70 61 72 61 6d 65  |x = first parame|
00002400  74 65 72 20 2b 20 73 65  63 6f 6e 64 20 70 61 72  |ter + second par|
00002410  61 6d 65 74 65 72 0a 20  20 20 20 20 20 20 20 22  |ameter.        "|
00002420  26 22 20 20 3a 20 69 6e  74 65 67 65 72 20 69 73  |&"  : integer is|
00002430  20 73 70 65 63 69 66 69  65 64 20 69 6e 20 68 65  | specified in he|
00002440  78 61 64 65 63 69 6d 61  6c 0a 0a 20 20 5b 33 5d  |xadecimal..  [3]|
00002450  20 42 65 66 6f 72 65 20  73 74 61 72 74 69 6e 67  | Before starting|
00002460  20 74 6f 20 73 65 61 72  63 68 20 46 69 6c 65 4d  | to search FileM|
00002470  61 74 63 68 20 77 69 6c  6c 20 72 65 61 64 20 74  |atch will read t|
00002480  68 65 20 43 53 44 20 73  74 61 74 75 73 2e 0a 20  |he CSD status.. |
00002490  20 20 20 20 20 57 68 65  6e 20 73 65 61 72 63 68  |     When search|
000024a0  69 6e 67 2c 20 46 69 6c  65 4d 61 74 63 68 20 77  |ing, FileMatch w|
000024b0  69 6c 6c 20 63 68 61 6e  67 65 20 74 68 65 20 43  |ill change the C|
000024c0  53 44 2e 20 57 68 65 6e  20 46 69 6c 65 4d 61 74  |SD. When FileMat|
000024d0  63 68 20 68 61 73 0a 20  20 20 20 20 20 66 69 6e  |ch has.      fin|
000024e0  69 73 68 65 64 20 73 65  61 72 63 68 69 6e 67 20  |ished searching |
000024f0  69 74 20 77 69 6c 6c 20  72 65 73 74 6f 72 65 20  |it will restore |
00002500  74 68 65 20 43 53 44 20  74 6f 20 74 68 65 20 6f  |the CSD to the o|
00002510  72 69 67 69 6e 61 6c 20  73 74 61 74 65 2e 0a 20  |riginal state.. |
00002520  20 20 20 20 20 54 6f 20  61 76 6f 69 64 20 61 6e  |     To avoid an|
00002530  79 20 70 6f 73 73 69 62  6c 65 20 70 72 6f 62 6c  |y possible probl|
00002540  65 6d 73 20 6f 63 63 75  72 72 69 6e 67 2c 20 64  |ems occurring, d|
00002550  6f 20 6e 6f 74 20 63 68  61 6e 67 65 20 74 68 65  |o not change the|
00002560  20 43 53 44 0a 20 20 20  20 20 20 77 68 65 6e 20  | CSD.      when |
00002570  46 69 6c 65 4d 61 74 63  68 20 69 73 20 72 75 6e  |FileMatch is run|
00002580  6e 69 6e 67 2e 20 41 6c  73 6f 2c 20 62 65 20 63  |ning. Also, be c|
00002590  61 72 65 66 75 6c 20 6f  66 20 63 72 65 61 74 69  |areful of creati|
000025a0  6e 67 20 6f 72 20 64 65  6c 65 74 69 6e 67 0a 20  |ng or deleting. |
000025b0  20 20 20 20 20 66 69 6c  65 73 20 77 68 69 6c 73  |     files whils|
000025c0  74 20 73 65 61 72 63 68  69 6e 67 2e 20 54 68 69  |t searching. Thi|
000025d0  73 20 6d 61 79 20 63 6f  6e 66 75 73 65 20 46 69  |s may confuse Fi|
000025e0  6c 65 4d 61 74 63 68 20  61 6e 64 20 6d 61 6b 65  |leMatch and make|
000025f0  20 69 74 0a 20 20 20 20  20 20 27 6c 6f 73 65 27  | it.      'lose'|
00002600  20 69 74 27 73 20 70 6c  61 63 65 2e 0a 0a 20 20  | it's place...  |
00002610  5b 34 5d 20 43 53 44 20  3d 20 63 75 72 72 65 6e  |[4] CSD = curren|
00002620  74 6c 79 20 73 65 6c 65  63 74 65 64 20 64 69 72  |tly selected dir|
00002630  65 63 74 6f 72 79 0a 0a  20 20 5b 35 5d 20 49 6e  |ectory..  [5] In|
00002640  20 74 68 65 20 61 62 6f  76 65 20 64 65 73 63 72  | the above descr|
00002650  69 70 74 69 6f 6e 73 20  22 66 69 6c 65 22 20 69  |iptions "file" i|
00002660  73 20 73 6f 6d 65 74 69  6d 65 73 20 75 73 65 64  |s sometimes used|
00002670  20 67 65 6e 65 72 69 63  61 6c 6c 79 20 74 6f 0a  | generically to.|
00002680  20 20 20 20 20 20 6d 65  61 6e 20 22 66 69 6c 65  |      mean "file|
00002690  73 22 2c 20 22 64 69 72  65 63 74 6f 72 69 65 73  |s", "directories|
000026a0  22 20 6f 72 20 22 69 6d  61 67 65 20 66 69 6c 65  |" or "image file|
000026b0  73 22 2e 20 54 68 65 73  65 20 70 6c 61 63 65 73  |s". These places|
000026c0  20 73 68 6f 75 6c 64 0a  20 20 20 20 20 20 62 65  | should.      be|
000026d0  20 6f 62 76 69 6f 75 73  2e 0a 0a 2d 2d 20 0a 2a  | obvious...-- .*|
000026e0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00002720  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 0a  |***************.|
00002730  2a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |*               |
00002740  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00002770  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 2a  |               *|
00002780  0a 2a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.*              |
00002790  20 20 20 20 20 20 20 20  20 20 20 20 20 43 6f 6e  |             Con|
000027a0  74 61 63 74 69 6e 67 20  74 68 65 20 61 75 74 68  |tacting the auth|
000027b0  6f 72 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |or              |
000027c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000027d0  2a 0a 2a 20 20 20 20 20  20 20 20 20 20 20 20 20  |*.*             |
000027e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 7e 7e  |              ~~|
000027f0  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |~~~~~~~~~~~~~~~~|
00002800  7e 7e 7e 20 20 20 20 20  20 20 20 20 20 20 20 20  |~~~             |
00002810  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002820  20 2a 0a 2a 20 20 20 20  20 20 20 20 20 20 20 20  | *.*            |
00002830  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00002870  20 20 2a 0a 2a 20 20 20  20 20 41 75 74 68 6f 72  |  *.*     Author|
00002880  3a 20 53 61 6e 6a 61 79  20 50 61 74 74 6e 69 20  |: Sanjay Pattni |
00002890  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000028c0  20 20 20 2a 0a 2a 20 20  20 20 41 64 64 72 65 73  |   *.*    Addres|
000028d0  73 3a 20 31 30 35 20 53  74 65 72 6c 69 6e 67 20  |s: 105 Sterling |
000028e0  50 6c 61 63 65 20 4c 6f  6e 64 6f 6e 20 57 35 20  |Place London W5 |
000028f0  34 52 44 2e 20 20 20 20  20 20 20 20 20 20 20 20  |4RD.            |
00002900  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002910  20 20 20 20 2a 0a 2a 20  20 20 20 20 20 20 54 65  |    *.*       Te|
00002920  6c 2e 3a 20 28 2b 34 34  29 20 28 30 29 20 31 38  |l.: (+44) (0) 18|
00002930  31 20 2d 20 35 36 38 20  39 31 36 37 20 20 20 20  |1 - 568 9167    |
00002940  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00002960  20 20 20 20 20 2a 0a 2a  20 20 20 20 20 20 45 6d  |     *.*      Em|
00002970  61 69 6c 3a 20 73 2e 70  61 74 74 6e 69 40 69 63  |ail: s.pattni@ic|
00002980  2e 61 63 2e 75 6b 20 20  20 20 20 20 20 20 20 20  |.ac.uk          |
00002990  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000029b0  20 20 20 20 20 20 2a 0a  2a 20 20 20 20 20 20 20  |      *.*       |
000029c0  20 57 57 57 3a 20 68 74  74 70 3a 2f 2f 77 77 77  | WWW: http://www|
000029d0  2e 70 70 2e 70 68 2e 69  63 2e 61 63 2e 75 6b 2f  |.pp.ph.ic.ac.uk/|
000029e0  7e 73 70 61 74 74 6e 69  2f 20 20 20 20 20 20 20  |~spattni/       |
000029f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002a00  20 20 20 20 20 20 20 2a  0a 2a 20 20 20 20 20 20  |       *.*      |
00002a10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00002a50  20 20 20 20 20 20 20 20  2a 0a 2a 2a 2a 2a 2a 2a  |        *.******|
00002a60  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00002aa0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 0a                 |**********.|
00002aab