       1mscanmatch 22m?4m-nocase24m? 4mcontexthandle24m ?4mregexp24m? 4mcommands0m

              Specify  Tcl 4mcommands24m, to be evaluated when 4mregexp24m is matched by
              a 1mscanfile 22mcommand.  The match is  added  to  the  scan  context
              specified  by 4mcontexthandle24m.  Any number of match statements may
              be specified for a give context.  4mRegexp24m is a regular expression
              (see  the 1mregexp 22mcommand).  If 1m-nocase 22mis specified as the first
              argument, the pattern is matched regardless of alphabetic case.

              If 4mregexp24m is not specified, then a default  match  is  specified
              for the scan context.  The default match will be executed when a
              line of the file does not match any of the  regular  expressions
              in the current scancontext.

              The  array  1mmatchInfo  22mis available to the Tcl code that is exe-
              cuted when an expression matches  (or  defaults).   It  contains
              information about the file being scanned and where within it the
              expression was matched.

              1mmatchInfo 22mis local to the top level of the match command  unless
              declared  global at that level by the Tcl 1mglobal 22mcommand.  If it
              is to be used as a global, it 4mmust24m  be  declared  global  before
              1mscanfile 22mis called (since 1mscanfile 22msets the 1mmatchInfo 22mbefore the
              match code is executed, a subsequent 1mglobal  22mwill  override  the
              local variable).  The following array entries are available:

              1mmatchInfo(line)0m
                     Contains  the  text  of  the  line  of  the file that was
                     matched.

              1mmatchInfo(offset)0m
                     The byte offset into the file of the first  character  of
                     the line that was matched.

              1mmatchInfo(linenum)0m
                     The  line  number  of  the line that was matched. This is
                     relative to the first line scanned, which is usually, but
                     not  necessarily,  the first line of the file.  The first
                     line is line number one.

              1mmatchInfo(context)0m
                     The context handle of the context that this scan is asso-
                     ciated with.

              1mmatchInfo(handle)0m
                     The file id (handle) of the file currently being scanned.

              1mmatchInfo(copyHandle)0m
                     The  file id (handle) of the file specified by the 1m-copy-0m
                     1mfile 22moption.  The element does not exist if 1m-copyfile 22mwas
                     not specified.

              1mmatchInfo(submatch0)0m
                     Will  contain the characters matching the first parenthe-
                     sized subexpression.  The second  will  be  contained  in
                     1msubmatch122m, etc.

              1mmatchInfo(subindex0)0m
                     Will  contain  the  a  list  of  the  starting and ending
                     indices of the string matching  the  first  parenthesized
                     subexpression.    The   second   will   be  contained  in
                     1msubindex122m, etc.

              All 1mscanmatch 22mpatterns that match a line will  be  processed  in
              the  order  in which their specifications were added to the scan
              context.  The remainder of the 1mscanmatch  22mpattern-command  pairs
              may  be skipped for a file line if a 1mcontinue 22mis executed by the
              Tcl code of a preceding, matched pattern.

              If a 1mreturn 22mis executed in the body of the  match  command,  the
              1mscanfile  22mcommand  currently in progress returns, with the value
              passed to 1mreturn 22mas its return value.
