       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.
