RehearseCode(1)                                                RehearseCode(1)

NAME
       RehearseCode - run through Mentor CodeView source file annotations.

SYNTAX
       RehearseCode filename1 [filename2 [... filename4]]

DESCRIPTION
       The  Mentor  CodeView  uses annotated files to display algorithm source
       code.  RehearseCode helps you check that multiple sources in  different
       languages have matching annotations by simultaneously displaying corre-
       sponding regions in the source files.

       The annotations indicate sections of the file to be used as the  source
       code  for a procedure, and delimit regions to be highlighted at a given
       point in the running program.  Regions are numbered within a procedure.
       A  procedure header has the form "@procedure-name0.  A matching trailer
       marks the end of the procedure.  Procedures must be disjoint.  The pro-
       cedure  header  implicitly starts region #0.  Other regions are started
       with numbered tags of the form "@#### ", where '#' is a decimal  digit.
       A single '@' character delimits the end of a region.  When an '@' char-
       acter appears in the source, another '@' can be used to quote it.  Here
       is a simple example:

               @GCD
               PROCEDURE GCD (u, v: INTEGER): INTEGER@ =
                 BEGIN
                   @1 IF v = 0 THEN@ @2 RETURN u;@
                            ELSE @3 RETURN GCD (v, u MOD v);@
                   END;
                 END GCD;
               @GCD

       RehearseCode  installs two windows: a control panel and a CodeView win-
       dow containing one view for each source file  specified.   The  control
       panel  consists of four buttons, a browser containing all the procedure
       names, and an error/information log.  File  access  errors,  annotation
       syntax errors, and annotation inconsistencies are written to the log.

       Clicking  on a procedure name causes the source for the procedure to be
       displayed as it will appear in each CodeView, with the procedure header
       highlighted (region #0).  Pressing the "Step" button will highlight the
       next region number from all the sources.  If that region  is  not  con-
       tained  in  a particular CodeView, its highlight will remain unchanged.
       When the regions  are  exhausted,  "Step"  restarts  at  the  procedure
       header.

       The  "Run"  button  automatically invokes "Step" periodically until the
       end of the sequence of regions is reached.  "Run" will also start  over
       if  invoked  when the last of the regions is highlighted.  Clicking any
       button or choosing a procedure name cancels the repeating  before  per-
       forming the chosen action.

       Choosing  "Reparse"  is  nearly the same as restarting the program: all
       current state is cleared and the annotated source files  are  read  and
       parsed again.  Window shapes are unaffected.

       "Exit" quits the program.
       Michael Sclafani
       Michael Sclafani

                                                               RehearseCode(1)