---
name: "RehearseCode"
section: "1"
platform: "linux"
package: "pm3-extra"
version: "1.1.15-1"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/RehearseCode"
---

# RehearseCode(1)

run through Mentor CodeView source file annotations.

## 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 corresponding 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  procedure 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 '@'  character 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 window  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 contained 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  performing 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.

## AUTHOR OF OBJECT

Michael Sclafani

## AUTHOR OF DOCUMENTATION

Michael Sclafani