
UNDERTOW(1)              USER COMMANDS                UNDERTOW(1)



NAME
     UNDERTOW- Revision 4.3.4- A  waveform  display  program  for
     Verilog Value Change Dump Files

SYNOPSIS
     ut [-v <dump file name>] [-s <save file name>] [V]

DESCRIPTION
     Undertow is a post-processor for Verilog Value  Change  Dump
     (VCD)  files.   It  uses  the  Athena  widget set to display
     waveforms graphically.


OPTIONS
     -v <dump file name>
          Specify the name of the VCD  file.   This  defaults  to
          "verilog.dump".


     -s <save file name>
          Specify the name of the save file. This has no default.
          More than one -s option can be entered onto the command
          line, in order to bring in multiple files of signals or
          aliases.


     -V <verbose mode>


     -r <real time mode>
          Starts ut with real time mode enabled. When  real  time
          mode  is  enabled,  the time interval for ut to look at
          the Value Change Dump file can  be  specified  as  fol-
          lows:( ut -r t n), where the n specifies in seconds the
          real time mode update time.


DISPLAY WINDOW
     The Display Window is made up of several areas:

                  Menu Buttons
                  Cursor Time Values
                  Fast Selection Menu
                  Signal Name List
                  Value List
                  Wave Display
                  Time Bars
                  Scroll Bars


Menu Buttons
     Each Individual Menu Button can be pinned up by clicking the
     menu  line.  The complete description of each feature listed
     in the menu can be found below.  See "BUTTONS".


Cursor Time Values
     There are three Time Cursors available with  Undertow.   The
     value  of  the  Time  Cursors  and the delta between them is
     listed at  the  top  right  of  the  window.   The  complete
     description  of  the  Time Cursors is found below.  See "The
     Time Buttons".


Fast Selection Menu
     There  are  several  commonly  used  features  that  can  be
     accessed  without  the  need  to  click  into a menu.  These
     feature are listed below the main Menu Buttons.



Signal Name List
     The Signal Name List is the left column of the main  display
     window.   All  or  part of selected signal names is shown in
     this column.  The whole signal name can be seen  by  holding
     the  right button down at any signal.  This produces a small
     pop-up window with  the  whole  signal  name.   This  window
     disappears automatically. If long signal names are required,
     this column can be widened.  To change a font size, or widen
     a column make the appropriate changes to the UNdertow file.


Value List
     The Value List is the middle column of the main display win-
     dow.   This  column  shows  a  value  for each signal at the
     current cursor position.  The format of  the  value  can  be
     changed  using the Format menu. The format of a value can be
     seen by holding the right button down at  any  value.   This
     produces  a small pop-up window with the whole signal value.
     This window disappears automatically.  If  long  values  are
     required,  this  column  can  be  widened.  To change a font
     size, or widen a column make the appropriate changes to  the
     UNdertow file.


Wave Display
     The Wave Display is the main portion of the display  window.
     This  area  is always the right side of the window as it can
     be elongated to beyond the scope  of  your  visible  screen.
     This  column can also be shortened by specifying a change in
     the UNdertow file.  The number of waves seen on  any  screen
     can  be  modified by changing the pixel width of each signal
     in the Undertow file.

Time Bars
     There are two Time Bars available  in  the  display  window.
     The  lower Time Bar shows the whole time of your simulation.
     The upper Time bar shows the visible time  of  your  simula-
     tion.


Scroll Bars
     There are two Scroll Bars available in the  display  window.
     The  horizontal  scroll  bar is located at the bottom of the
     screen.  The vertical scroll bar is located at the  left  of
     the  screen.   To move the scroll bars, use the middle mouse
     button.


BUTTONS
    File opens a pull-down menu containing the following buttons:

          Open- opens a dialog box that allows the user to select
          a  file to open.  This dialog box has three fields, the
          "Directory" field indicating  the  current  directories
          within the current directory which can be selected, the
          "Files"  field  which  shows  the  files  that  can  be
          selected,  and  the  "File To Use" field that shows the
          directory path and file to be opened. A path  and  file
          can  be  entered manually on the File To Use field. The
          directory field is traversed up and down by selecting a
          directory  with  the  left  mouse button in order to go
          into that directory, or selecting the two periods above
          the  directory  at  the top of the list, to traverse up
          one directory level.  Files can  be  opened  by  double
          clicking  on  the file name.  Partial file names can be
          put into the "File to Use" field and the directory will
          position itself to that path.  In addition, the charac-
          ter "~" can be used to get to the home directory.  Load
          Fast  File- this button creates and loads the fast file
          version  of  the  VCD  file  that  has  been  selected.
          Selecting  Open  (below  the "File To Use" field) opens
          the  file.   Selecting  Exit  closes  this  dialog  box
          without taking any action.

          Close- closes the current display file.

          Save- saves the signal names of the current display  in
          a file (specified by user).

          Save All- in  addition  to  the  signal  names  of  the
          current  display file "Save All" saves other parameters
          that have been set up during the session.  This enables
          "restore" to bring back the exact state of your current
          display session.

          Restore- restores the display with the signals  from  a
          file (specified by user).

          Start New Undertow- starts a new copy of Undertow.

          Sync Undertows  (on/off)  Syncronizes  both  copies  of
          Undertow  together. Moving the horizontal scroll bar in
          one or the zoom controls preforms the  same  action  in
          the other Undertow.

          Print Signals-  prints  the  signals  which  have  been
          selected  in  the  current display to the line printer.
          The start time and end time for  the  print  output  is
          defined  by  the  position and length of the horizontal
          scroll bar. The user can print to a  printer  or  to  a
          file  and  can  select landscape or portrait mode, font
          size, signal line width, a border, and printing  signal
          values.  Additionally,  the  user  can manually set the
          time for the print by changing the time for  the  start
          and/or  end  times.  Since the printing takes places in
          the scale as  shown  in  the  current  display  window,
          increasing the time for printing will cause the signals
          to be printed over several pages. The signals have been
          adjusted  so that several pages of signals can be lined
          up  and  taped  together  to  provide  one   continuous
          waveform print.

          Print Output- brings up  a  print  dialogue  box  which
          allows  the  user  to  send the output window to a file
          (specified by user) or to the line  printer  (specified
          by user).

          Create Fast File- creates a new file that allows under-
          tow to dispay signals extremely fast.  The program runs
          on existing completed dump files or  on  VCD  files  as
          they  are  being  built  by the Verilog simulator.  The
          Create Fast File works in the background, so that  once
          the user has enabled this function he can go on working
          with all of the other facilities of Undertow.

          Create Auxiliary Output- brings up a  dialogue  window.
          This  box allows the user to specify parameters in mak-
          ing an auxiliary file which is used  to  speed  up  the
          display operation. The Create Auxiliary File Box allows
          the user to build two  auxiliary  files.   The  Primary
          Auxiliary  File allows the user to specify a time point
          to Start and End the  Primary  Auxiliary  File.   These
          time  points  come up in default values which equal the
          Start and End of the simulation.  The interval at which
          the  primary  file  will  build  its signal list can be
          specified directly with buttons that can be set  to  1,
          5, 10, 20, or a manual entry. This interval is the sig-
          nal list. The Secondary Auxiliary File allows the  user
          to specify a time point to start the secondary  Auxili-
          ary  File.  These time points come up in default values
          which equal the start and end of the horizontal  scroll
          bar.   The  interval  at  which the secondary file will
          build its signal list can be  specified  directly  with
          buttons  that  can  be set to 1, 5, 10, 20, or a manual
          entry.  This interval is the number of times  that  the
          auxiliary file builds the signal list.

            NOTE:  The  more  times  the  signal  list  is  built
            (Number  of  Intervals)  the  faster the signals will
            display from the VCD file.  However  the  larger  the
            "Number  of  Intervals" the larger the auxiliary file
            will become.  This interval is set to 10 by  default.
            While the user should experiment with the time inter-
            val, it is recommended as a starting  point  for  the
            Primary  Auxiliary  File  that  the  time interval be
            equal to ten for the entire time of  the  simulation.
            The  interval that is recommended as a starting point
            for the Secondary Auxiliary  File  is  ten  intervals
            over  the  portion  of  the  simulation that the user
            wants to display during this session.   If  the  user
            moves  the  horizontal  scroll  bar  to this area the
            Secondary Start and End times will be  set  correctly
            by  default when the Create Auxiliary is next brought
            up.

            Create Reduced Dumpfile- brings up a dialogue  window
            that  allows a new smaller dumpfile to be built.  The
            New Dumpfile Size is specified by buttons.  The  size
            can  be  set  to 10,20,50, or a manual entry in mega-
            bytes.  Otherwise, the new dumpfile can be built with
            a specified Start and End time.

            Help- brings up a help window.

            Quit- Quits execution of the currently  running  pro-
            gram.

    Edit opens a pull-down menu containing the following buttons:

          Select All- selects all signals.

          Cut- cuts all selected signals from  the  display  into
          the cut/copy buffer.

          Copy- copies all selected  signals  into  the  cut/copy
          buffer.

          Paste- pastes the signals from the cut/copy buffer into
          inserts before the selected signal.  If  no  signal  is
          selected,  the  paste  will  append  to  the end of the
          display.

            NOTE:  In addition to selecting signals with the left
            mouse button individually, signals can be selected in
            groups by clicking the left button on the first  sig-
            nal  to be selected and clicking the middle button on
            the last in a sequence of  signals  to  be  selected.
            Continuing  to  click the middle button will continue
            to add signals to the selected list.

    Format opens a pull-down menu containing the  following  but-
    tons:

          Hexadecimal- converts the value of the  signal  at  the
          cursor into hexadecimal format.

          Binary- converts the value of the signal at the  cursor
          into binary format.

          Decimal- converts the value of the signal at the cursor
          into decimal format.

          Octal- converts the value of the signal at  the  cursor
          into an octal format.

          ASCII- converts the value of the signal at  the  cursor
          into its equivalent ascii character

          Normal if the value had been converted to ones  comple-
          ment  or  twos  complement, normal returns the value to
          the uncomplemented value.

          Ones Complement- converts the value to the ones comple-
          ment  of  the  value.  This is equivalent to the binary
          invertion of this value.

          Twos complement- converts the value to the twos comple-
          ment  of the value. This is equivalent to the ones com-
          plement of the value with a one added to it.

    Group opens a pull-down menu containing  the  following  but-
    tons:

          Display Group A -  D-  inserts  the  group  of  signals
          assigned to "A - D" into the top of the display window.

          Load Group From File- opens the  file  load  window  to
          allow  the user to select a group of signals found in a
          file, then when this group is selected,  inserts  these

          Clear- clears the last group inserted by "Display Group
          A - D".

          Clear  All  Groups-  clears  all  groups  inserted   by
          "Display Group A - D".

          Assign Group A - D- assigns all selected  (highlighted)
          signals to Group A - D.

          Save Group To File- opens the save file window to allow
          the user to specify a file to assign selected signals.

          Additional Groups- opens a pinnable menu  that  has  26
          groups  A  - Z. The operation buttons are provided that
          do the following:

              Clear- clears the last group inserted  by  "Display
              Group A - Z".

              Clear All Groups- clears  all  groups  inserted  by
              "Display Group A - Z

              Display- inserts the group of signals  assigned  to
              "A  -  Z"  into  the top of the display window. The
              sequence of operations are: set  Display  on,  then
              select group.

              Change Name- Changes the name of the selected group
              (group that is currently highlighted).

              Assign- assigns all selected (highlighted)  signals
              to  Group  A  -  Z. The sequence of operations are:
              Toggel Assign on, select signals from  the  display
              window and select the group to assign these signals
              to.

    Options opens a pull-down menu containing the following  but-
    tons:

          Choose- opens the choose window which allows signals to
          be selected. (See Choose Window Description.)

          Text- opens the  text  window.   The  text  window  can
          accept  signal  names  selected from the signal display
          window or signal names can be  entered  from  the  key-
          board.   The  top  line of the text window contains the
          current scope for this text window.  The  signal  names
          are  constructed  using  the  inputed  signal name con-
          catenated to the scope.  The inputed  signal  name  can
          override  the  current  scope  by  starting with a "/".
          Signal names can contain "*" wild  card  characters  in
          their signal names.  (i.e. c*, ab*, etc.)  Signals that
          are bussed can be "unbundled"  (i.e.  Ab[31:0]  can  be
          modified  to  Ab[31:24]).  Busses can be reversed using
          the Text window simply  be  selecting  the  bus  to  be
          reversed from the display window, Copy and Pasting this
          signal to the Text window, changing the order that  the
          bus  is  specified in the text window, and readding the
          signal back to the display window.(ie.  AB[31:0}  could
          be  changed  to AB[0:31}.  The text window has the fol-
          lowing buttons:

              Copy & Paste- inputs to  the  text  window  signals
              selected from the display.

              Clear- clears the text window.

              Add- adds the signals in the  text  window  to  the
              display.

              Cancel- dismisses the  text  window  without  doing
              anything.

          NOTE: The text window is build from the a general  pur-
          pose text widget. Other windows that are built from the
          text widget are the alias window, the group window, the
          Scroll  Search  Window, the Scroll Frequent Window, and
          the text "Variables" subwindow which is in  the  Choose
          window. All of these text windows have some of the fol-
          lowing actions:

              Control s- brings up a text  string  search  window
              for  forward  searches. A string can be entered and
              the text window searched forward for  this  string.
              When  found the entry equal to the search string is
              selected.

              Control r- brings up a text  string  search  window
              for  backward searches. A string can be entered and
              the text window searched backward for this  string.
              When  found the entry equal to the search string is
              selected.

              Meta i- brings up a file insert menu. A  file  name
              can  be  entered which will be loaded into the text
              window.

          Group Signals- opens  the  group  signals  window  that
          allows  signals  on  the  display  window to be grouped
          together into one bussed  signal.   The  group  signals
          window  has  two input lines.  On the top line the user
          enters the name for the new  group  (this  name  should
          have  no  "/"s  anywhere  in  the name).  On the bottom
          input line the user enters  signal  names  for  signals
          which are to be included in this group.  The group sig-
          nal window has the following buttons:

              Copy & Paste- copies the signal name selected  from
              the display window to this input field.  The Copy &
              Paste button is a toggle button.  When  it  is  set
              the  first the time, all of the highlighted signals
              in the display signal list are put into  the  Paste
              area  in order from top to bottom.  Once the Copy &
              Paste button is  pressed,  it  becomes  highlighted
              indicating that any signal selected after this time
              will be put in the paste area in the order in which
              it  has been selected.  This allows the user to put
              signals in the Paste area in any desired order.

              Add- adds this group  definition  to  the  list  of
              groups for the current display.

              Delete- removes the selected signals from the  list
              of signals to be added to this group.

              Add & Display- performs the same as "Add" but  also
              displays the group.

          Alias- opens the  alias  window.   This  window  allows
          users to alias values of signals to textual names.  The
          user inputs a list of aliases and their values.   Exam-
          ple:
                  LOAD = 0
                  ADD  = 1
                  SUB  = 2
                  MOVE = 3
                  JUMP = 4

          To add this alias to a signal, the user selects a  sig-
          nal  from  the  display  signal list and presses "Add".
          The following describes the function buttons for alias.

              Add- adds the alias to the selected signal(s).

              Full Path (on/off)- This causes  the  alias  to  be
              added,  to added only to the signal specified (on),
              or to added to be added to all  signals  with  this
              same name ignoring the path name entirely.

              Delete-  deletes  all  aliases  from  the  selected
              signal(s).

              Clear- clears the window.

              Scroll Set Interval- allows the user to set  verti-
              cal  scroll granularity.  The user selects two sig-
              nals on the display window and  scroll  granularity
              is set to this distance.

              Scroll 90%- sets scroll granularity to 90% of vert-
              ical window.

              Scroll Search All- brings up a window with  all  of
              the  signals  currently  on the display window. The
              user can choose any signal and  cause  the  display
              window  to  scroll  to  this  point.   The user can
              select signals to be sent to the Scroll Search Fre-
              quent window.

              Scroll Search Frequent- holds signals that the user
              frequently  uses.   Selecting a signal and pressing
              "Scroll" causes the display  window  to  scroll  to
              this signal.

          Auto Update- is a toggle button.  When Auto  Update  is
          "off"  all  values  on the screen are not automatically
          updated to their correct values.  Instead,  the  values
          brought into the display window data base when the user
          returns from the choose window are the values from  the
          VCD  file over the time period that is indicated by the
          horizontal scroll bar.  If no transition  exists  on  a
          signal in this region it's value will be indicated by a
          question mark.  Running the display  with  Auto  Update
          "On"  (and  not running with the fast format) can cause
          the signal update to take a significant amount of  time
          with  large VCD files.  When the user gets to the point
          where he wants all of the signal values to be  correct,
          he  can  enable  "Update Signals" on the Fast Selection
          menu or in the "Actions Menu".   When  Auto  Update  is
          "on" all values on the screen are automatically updated
          to their correct value.

          Update Signals- will update the display for the correct
          signal  values (which is required when "Auto Update" in
          the "Preferences" menu is turned off).   Update  should
          be  done  any  time  signal values appear on the screen
          with the value "?".  This will occur  when  the  scroll
          bar  is  moved  to  different  points of the screen and
          these signal values have not previously been read  into
          the  display  window data base or when zooming out with
          "Zoom Out" or "Full Zoom".

          Real Time Mode(off)- a toggle button  that  enables  or
          disables   real-time   mode.   Real  Time  Mode  causes
          Undertow to examine the Value Change Dump File  to  see
          if  it  is  growing.  If this file is growing, Undertow
          will update the signal data.  The interval that  Under-
          tow  will  check  the  VCD  file is defined by the user
          using the Set Real Time Mode Interval Button (found  in
          the Preference menu).

          Real Time Interval- Real Time Interval brings up a win-
          dow  where  the user can set the interval that Undertow
          willexamine the VCD file if Real Time  Mode  is  on  to
          determine  if an update is required due to the VCD file
          increasing in size.

          Time Scale- opens a window which  allows  the  user  to
          divide  the  time  units  he is displaying and to set a
          time unit to be put on the time display.

	  Tools- a menu that holds all of the Undertow Design
	  analysis tools.

	  The Test Analyzer has the following buttons:
          Compare One Signal-allows the user to select one signal
          from each display window (the names of these signals do
          not have to be the same)  and  compare  the  values  of
          these  two  signals.  Areas of differences between sig-
          nals are indicated with purple highlighting on the sig-
          nal in the window from which test analyzer was enabled.

          Compare Signals (Same Name)-allows the user  to  select
          one or more signals from one display window and to com-
          pare these signals to signals with the same name in the
          other  display window.  Signals that do not compare are
          indicated in the window called "Test Analyzer Results".
          This  window  allows  the  user to select signals which
          have miscompared, and to display these signals.

          If the signals currently are not on the display  window
          they  will  be  added  along with the highlighted areas
          that have miscompared. Compare  list  of  signals,  and
          Compare  All  Signals  are examples of operations where
          the signals may not be currently displayed.

          Compare List of Signals-enabling this button brings  up
          a  window from which a list of signals made with "save"
          are compared between the VCD files in the  two  display
          windows. Signals which miscompare are put into the win-
          dow "Test Analyzer Results".

          Compare All Signals- compares all signals  in  the  two
          VCD files opened by the two different Undertow windows.

          Specify Timing Window-brings up a window  which  allows
          the  user to select either the leading or trailing edge
          of a clock, the clock signal and two points  on  either
          side of the leading edge or trailing edge of the clock.
          To allow this timing  window  to  be  effective,  "set"
          should  be  enabled.  If  the plus and minus values are
          set, then the comparison takes place from the point  of
          the minus setting through to the point of the plus set-
          ting around the clock edge.

	The Test Analyzer has the following buttons:

	Compare One Signal-allows the user to select
	one signal from each display window (the names of these
	signals do not have to be the same) and compare the
	values of these two signals.  Areas of differences
	between signals are indicated with purple highlighting on the
	signal in the window from which test analyzer was enabled.

	Compare Signals (Same Name)-allows the user to select 
	one or more signals from one display window and
	to compare these signals to signals with the same 
	name in the other display window.
	Signals that do not compare are indicated in the window
	called "Test Analyzer Results".  This window allows the
	user to select signals which have miscompared, and
	to display these signals.  

	If the signals currently are not on the
	display window they will be added along with the
	highlighted areas that have miscompared.  
	Compare list of signals, and Compare All Signals are examples
	of operations where the signals may not be currently
	displayed.

	Compare List of Signals-enabling this button brings up
	a window from which a list of signals made with "save"
	are compared between the VCD files in the two display windows.  
	Signals which miscompare are put into the window 
	"Test Analyzer Results". 

	Compare All Signals- compares all signals in the two
	VCD files opened by the two different Undertow windows.

	Specify Timing Window-brings up a window which allows the user to
	select either the leading or trailing edge of a clock, 
	the clock signal and two points on either side of
	the leading edge or trailing edge of the clock.  
	To allow this timing window to be effective, "set" should be enabled.  
	If the plus and minus values are set, then the comparison takes
	place from the point of the minus setting through to the point
	of the plus setting around the clock edge.
	
        The Time Buttons-
        The five values to the right  of  the  Preference  Menu
        button   are  time  displays.   There  are  three  time
        cursers, T0, set with the middle mouse button,  T1  set
        with  the middle mouse button while depressing the con-
        trol key, and T2, set  with  the  middle  mouse  button
        while depressing the shift key. On the display, T0 is a
        solid line, T1 is a dashed line with  alternating  line
        and blank areas. T2 is a dashed line with the line area
        twice as long as the blank area. On the display  window
        T0  is  the  first  value  (left most), T1 is the third
        value from the left, and T2 is the fifth value from the
        left.  The second value from the left is the delta time
        between T0 and T1, the fourth value from  the  left  is
        the  delta  time between T1 and T2. Additional non-time
        cursors can be entered manually by pressing the  middle
        mouse  button  and the meta key. These non-time cursors
        are cleared with the Clear Cursors button of the Action
        menu.

    Fast Selection Menu- The Fast Selection Menu includes buttons
    that  would  frequently  be  used  during  a display session.
    These buttons are:  "Select  All",  "Cut",  "Copy",  "Paste",
    "Choose",  "Zoom  In",  "Zoom  Out",  "Zoom  Full",  "Update"
    "GoTo", "Snap", and "Help".   These  buttons  have  the  same
    function  as their counterparts in the pull-down menus.  Help
    in the Fast Selection Menu is the user guide for  the  signal
    display window only.

    Choose Window- When the choose button is pressed,  the  name,
    value  and  waveform  displays  are  replaced with the choose
    screen.  It has three main areas; the menu  area, the  module
    list and the signal list.

          Upscope- changes the current scope up one level.

          Display- dismisses the choose screen and adds the  sig-
          nals on the display list to the display window.

          Abort- dismisses the Choose  Window  without  searching
          out any data from the VCD file.

          All- selects all signals in the current scope.

          Select- when the Variables Window is set  to  the  text
          widget,   select   will  select  all  of  the  selected
          (highlighted) signals to be added to the  display  win-
          dow.

          Options

          List Widget/Text Widget- the Variables  Window  can  be
          set  to either a list widget or a text widget.  The two
          widgets have different properties.

              List Widget- signals are selected by  pressing  the
              left  button  over  the  desired signal.  Groups of
              signals are selected by  selecting  a  signal  name
              with  the middle button and another signal with the
              middle button.  All signals  between  these  selec-
              tions  are  selected.   If  all of the signals in a
              group are already selected by  this  Choose  Window
              session  then  all of the signals in this group are
              unselected.  Signals  selected  are  added  to  the
              display window.

              Text Widget- signals can be  selected  by  pressing
              the left mouse button over the signal and releasing
              or holding the mouse button down and  dragging  the
              cursor over a number of signals.  These signals are
              only added to the display window selection list  if
              the select button in the menu area is pressed.

              Display Interval brings up a menu that  allows  the
              user  to  set  the  zoom, or display interval.  The
              current interval is shown at  the  bottom  of  this
              menu  as:  Start,  and  End times. These values are
              manually settable to allow the user to  change  the
              zoom time when the display window is brought back.

              Time Interval To Display- This menu  line  contains
              both  the  time  values  to be used to read the VCD
              file  and  buttons  which  can  change  these  time
              values.

          Minimum Time_ sets the start and end zoom time  to  the
          values which give the smallest separation between these
          values, to allow the display window to come up  in  the
          shortest amount of time.

          Current Display Time- sets the start and end  time  for
          the  current  display equal to the values as defined by
          the horizontal scroll bar on the display window.   Nor-
          mally  when  you  go to the "Choose" window these times
          are initially set to the times as defined by  the  hor-
          izontal scroll bar.

          3X Current Times- sets the display area to 3 times  the
          area  as  defined  by  the horizontal scroll bar on the
          display window.

          5X Current Times- sets the display area to 5 times  the
          area  as  defined  by  the horizontal scroll bar on the
          display window.

          All Times- sets the time value to be displayed starting
          with  the beginning of the simulation to the end of the
          simulation.

          Start- defines the time in  the  simulation  where  the
          signals  are to be brought into the display window data
          base.

          End- defines the ending time in  the  simulation  where
          the  signals  are  brought into the display window data
          base.  Note:  This area in the data base can be  larger
          than  the  area displayed (which is defined by the hor-
          izontal scroll bar).  Bringing  signal  data  into  the
          data  base over time which is larger than that which is
          displayed, allows the user to  scroll  over  this  data
          base   area  without  requiring  that  the  signals  be
          updated.

          Show Group- when the Variables Window  is  set  to  the
          list  widget,  Show Group highlights the top and bottom
          signals in the last group selected.

          Show Selected- lists out all of  the  signals  selected
          (the display signal list) up until this time.

          Verbose(off)- a toggle button that can be used to  show
          all  of  the signals added or deleted as they are added
          to the display window update list.   The  state  inside
          the  bracket  indicates the current state of the toggle
          button.

          All Times- sets the time value to be displayed starting
          with  the beginning of the simulation to the end of the
          simulation.

          Start- defines the time in  the  simulation  where  the
          signals  are to be brought into the display window data
          base.

          End- defines the ending time in  the  simulation  where
          the  signals  are  brought into the display window data
          base.  Note:  This area in the data base can be  larger
          than  the  area displayed (which is defined by the hor-
          izontal scroll bar).  Bringing  signal  data  into  the
          data  base over time which is larger than that which is
          displayed, allows the user to  scroll  over  this  data
          base   area  without  requiring  that  the  signals  be
          updated.

          Fast Signal Displays- In  order  to  make  the  signals
          display quickly the user should do the following steps:

               1. Build an auxiliary file of the  VCD  file  that
               will  be  displayed  using "Create Auxiliary File"
               found in the "File" menu.
               2. Go  to  the  "Choose"  window  and  select  the
               desired signals.
               3. Display the signals.
               4. After a few seconds, stop the signal update  by
               pressing "Stop/Update&Display".  The signal update
               will be stopped at this point and the display win-
               dow  opened  with just a small portion of the sig-
               nals valid.
               5. The user should then "Zoom In"  to  the  signal
               area  of  interest.   If  "Auto Update" is off you
               should update the signal values at this point (see
               Actions  menu  "Update").   If the zoom in area is
               appropriately defined and the auxiliary  file  was
               built  with  the  appropriate intervals the signal
               display will be very fast.

          Note on Signal Selection -

          Signals that are already  on  the  display  window  are
          marked with an "*".  Any signal that is selected during
          this choose window session is marked with a "+".  A "+"
          overrides  a  "*".   Any  signal  with  a  "+"  can  be
          unselected by pressing the left button over  this  sig-
          nal.  Any  group  of signals can be unselected  if this
          group is selected, and all signals in this  group  have
          already  been  selected  during this Choose Window ses-
          sion.)

          Using the Text Window (from The Options  Menu)  to  add
          signals  to the display selection list: The Text Window
          can be used during a Choose Window session to add  sig-
          nal  names  to the display signal list. This allows the
          entire  signal  list  before adding any signal names to
          the display signal  list.  When  brought  up  during  a
          Choose  Window session, the Text Window has the follow-
          ing buttons:

              Copy and Paste- For the  list  widget,  the  signal
              name that is highlighted or the last group selected
              is pasted to the Text Window and deleted  from  the
              display  selection  list.  For the Text Widget, all
              signals that are high lighted are pasted on to  the
              Text Window. Signal names on the Text Window can be
              modified to unbundle busses. Signal  names  can  be
              typed   onto  the  Text  Window  directly  and  can
              include wild card characters "*".

              Clear- clears the selected signal(s)  on  the  Text
              Window. If no signal is selected the Text Window is
              cleared of all signals.

              Add- adds the signal(s) shown on the Text Window to
              the display selection list.

              Cancel- dismisses the Text Window.

          Scroll bars-
              The vertical scroll bar at the left of  the  screen
              scrolls  through  the  displayed signals if they do
              not all fit on the screen.  The  horizontal  scroll
              bar  at  the  bottom  of the screen scrolls through
              time in the simulations.  Note that the "thumb"  or
              gray  area size denotes what portion of the simula-
              tion is currently on display.  The  window  may  be
              scrolled  by moving the pointer onto the scroll bar
              and depressing the middle mouse button.

          < and > buttons-
              These buttons to the left and right of the horizon-
              tal  scroll  bar  scroll the simulation .9 "screen-
              fuls" of data to the  right  or  the  left  or  the
              scroll resolution as set from the Preference Menu.

              markers-
                  The markers appear as small "x"'s on the screen
                  and are placed at the pointer position when the
                  first mouse button is pressed.   These  control
                  the  zoom function.  Each of the first two but-
                  ton presses place a marker, and the third  but-
                  ton  press  (of  the  1st  mouse button) erases
                  them.

          Bind Keys
              Bind Keys  are  included  with  Undertow  IV.   The
              current  value of the bind keys is specified in the
              UNdertow default file.   Please  see  the  complete
              list     in     the     Undertow     file     under
              "Undertow*TopForm.translations".

              vdump
                  The vdump utility is a utility that is used  by
                  the  Undertow program to create the fast files.
                  It is envoked when ever the "Create Fast File",
                  or  "Load  Fast  File", buutons are enabled. It
                  also can be used as a stand  alone  utility  to
                  create fast files, and it can be used to create
                  a fast file from a named pipe. To create a fast
                  file  using a named pipe type in the following:
                       %vdump -xcpu dumpfile name and then  start
                  the  verilog  simulation  with  the  dump  file
                  specifying the same dump file name.  This  will
                  produce  a  Fast  File  without producing a VCD
                  file. The command line options for using  vdump
                  stand alone are listed as follows:

                  Usage: vdump [-vRxcun] [[-[r|b|m|t|T]  #]  ...]
                  [-o outfile] dumpfile Boolean key definitions:
                          -v: Enable verbose output  to  standard
                  error.
                          -R: Run in real time mode.
                          -x: don't exit on errors if possible
                          -c: compress clock signals
                          -p: process though named pipe
                          -u: unlink (remove) original file  when
                  done
                          -n: make up fast  file  name  based  on
                  input   file  name  Argument  descriptions  and
                  defaults:
                          -b:  primary  block  size  for  signals
                  information
                          -m: secondary  (more)  block  size  for
                  signals information
                          -t: specify start time for reduced file
                  formats
                          -T: specify end time for  reduced  file
                  formats
                          -r #minutes:    (default=10 minutes).
                          -o outfile:     (default=ut.dump).
                          dumpfile:       (default=verilog.dump).


INPUT FILES
     Value Change Dump File
          This is the file generated  by  the  verilog  $dumpvars

          section and the data section.  The definitions  section
          defines  the  hierarchy  of  the design and all signals
          defined in the design.  The data  section  defines  the
          changes of those signals over time.

          To create a Verilog value change  file,  the  $dumpfile
          system task is used.  It takes one parameter which is a
          string containing the name of the file to  create.   If
          this   task   is   omitted,   the   name   defaults  to
          "verilog.dump" This command should  be  executed  once,
          prior to any $dumpvars tasks.

          To specify which variables to dump, the $dumpvars  task
          is used.  This task takes zero, one, or two parameters.
          If no parameters are given, then all variables  in  the
          design  are  dumped.   To dump all variables in a given
          module and all its submodules,  execute  the  $dumpvars
          command with the module instantiation name as a parame-
          ter.  To dump all variables in a module down to a given
          level of submodules, execute the $dumpvars command with
          two parameters.  The first parameter is the  number  of
          levels  to  dump  and the second is the module to dump.
          As many $dumpvars commands as desired can be  executed,
          but  they  must  all be executed at the same simulation
          time.

          For example,

                initial begin

                   // dump values to mydesign.dump
                   $dumpfile ("mydesign.dump");

                   // dump all variables in module adder_2
                   // and all its submodules
                   $dumpvars(adder_2);

                   // add all variables in module adder_3 only
                   $dumpvars(1, adder_3);

                   // add all variables in module adder_4 and
                   // only the submodules adder_4 instantiates
                   $dumpvars(2, adder_4);

                   // add all of the variables in the design
                   $dumpvars;

                   end


     Save File

     	  This defines a list of signals to display at startup of
          undertow.   Note  that  the  entries  in  the file must
          correspond exactly with the names in  the  simulations.
          All  busses  are  referred to in their compacted state,
          rather than as individual bits.

          /test/cg/clock
          /test/cg/reset
          /test/cg/sync
          /test/expect_list [64:0]
          /test/input_list [68:0]
          /test/t/a [31:0]
          /test/t/b_byte_pointer [1:0]
          /test/t/complete
          /test/t/product [15:0]
          /test/t/sync


     Application Defaults File
          The application defaults file is called  UNdertow.   It
          should  be  located  in each users /home directory/app-
          defaults/UNdertow.  This file  specifies  much  of  the
          look and feel of ut(1), UNDERTOW IV.  All of the values
          listed are the defaults.  Therefore, this file  is  not
          needed unless you want to change something.

! UNdertow application defaults file
! put in ~/app-defaults/UNdertow (yes, capitalization as noted!)
! and "setenv XAPPLRESDIR $(HOME)/app-defaults" in your .login or
! .cshrc

! please note that this file will have no effect
! whatsoever unless the appropriate lines have the "!"
! comment delimiter removed.

! the values listed below are the defaults
! as of 11/6/91 (except for the geometry,
! which has no default).

! Translations:
! A '!' indicates that only the listed modifiers must be held down.
! (Shift, Meta, Alt, Ctrl, etc.)
! A space-separated list of modifiers can also be used.

! Translations for the actusl waveforms
!UNdertow*WaveWindow.translations: #override0<Expose>:          exposeWaveWindow()0<Btn1Down>:        setPoint()0!Meta<Btn2Down>:   moveCursor(0)0!Ctrl<Btn2Down>:   moveCursor(2)0!Shift<Btn2Down>:  moveCursor(3)0None<Btn2Down>:    moveCursor(1)0<Btn3Down>:        doZoom()

! to place the window automatically at window coordinates 50,50
! as measured from the upper left hand corner of the screen
!UNdertow.geometry:      +50+50

! the signal "text" window
!signal_popup.geometry:       +250+275

! window for creating aliases
!alias_popup.geometry:        +100+200

! window for creating groups
!group_popup.geometry:        +200+250

! dialog window for creating reduced dumpfiles
!comp_window.geometry:      +300+300

! dialog window for printing text dumps
!print_window.geometry:      +200+400

! dialog window for OK/Cancel questions
!confirm_window.geometry:      +400+300

! informational dialog window
!monitor_window.geometry:      +400+300

! dialog window for important information
!notify_window.geometry:      +400+300

! scrolling window for text dumps
!output_window.geometry:      +350+325

! informational dialog window with cancel button
!cancel_window.geometry: +400+300

! dialog window to abort load fast file
!flush_window.geometry:       +400+300

! dialog window for selecting files
!select_window.geometry:      +200+300

! help window
!help_window.geometry:      +450+375

! dialog window for printing text dumps
!print_window.geometry:      +200+400

! dialog window for setting horizontal scrolling preferences
!horiz_pref_window.geometry:      +400+400

! dialog window for setting vertical scrolling preferences
!vert_pref_window.geometry:      +400+400

! dialog window for setting the time divisor and units preferences
!time_pref_window.geometry:      +200+400

! dialog window for setting the real-time interval preference
!interval_pref_window.geometry:      +200+400

! dialog window for printing signal waveforms in postscript format
!psp_window.geometry:      +200+400

! dialog window for creating an auxiliary file
!aux_window.geometry:      +300+300

! dialog window for goto time/vale/LE/TE
!goto_window.geometry:      +200+400

! window for scroll search all
!all_window.geometry:      +200+400

! window for scroll search frequent
!freq_window.geometry:      +200+400

! window for reduced fast file creation
!ut_reduce_window.geometry:        +200+300

! window for entering display interval
!load_time_window.geometry:        +400+200

! scope seperator ie. : /g4/iop/..../signal, not '[', ']', '*', '.', or ':'
!UNdertow.scopeSeparator:     /

! number of pixels vertical for 1 wave
!UNdertow.waveHeight:         20

! number of pixels horiz. for 1 wave
!UNdertow.waveWidth:          600

! number of pixels horiz for signal name
!UNdertow.signalWidth:        200

! number of pixels horiz for signal value
!UNdertow.valueWidth:         100

! number of waves on screen at startup
!UNdertow.numWaves:      15

! horizontal distance between wave and edge of window
!UNdertow.waveHorizDistance:  4

! vert distance between waves
!UNdertow.waveVertDistance:   4

! width of borders for waves, values and signals
!UNdertow.waveBorderWidth:    1

! display as much of hierarchy as possible
!UNdertow.longNames:          True

! time divisor
!UNdertow.timeDivisor:        1

! time units label
!UNdertow.timeLabel:

! fix bug in Verilog dumpfiles for split buses
!UNdertow.fixDumpfile:        True

! choose whether or not to display leading zeros
!UNdertow.leadingZero:        True

! force split buses to be:
! 0 = bus_name[0:n-1]
! 1 = bus_name[n-1:0]
! -1 = order found in file
!UNdertow.forceBitOrder: -1

! set to True to have default Signal values printed
!UNdertow.signalValuesPrinted:  True

! set to True to have default border on (for printing)
!UNdertow.borderOn: True

! set to True to have AutoScaling on, False for Manual as default
UNdertow.autoScaling:   True

! set to True to avoid printer stack overflows
!UNdertow.smallPrinterStack:  True

! choose a module scope delimiter character (not '[', ']', ':')
!UNdertow.scopeDelimiter:     /

! set to True for auto update of partially read signals
!UNdertow.findUnknownStarts:  True

! set to True to get the quick pick bar
!UNdertow.quickPickBar:       True

! set to True to snap cursors to signal transitions
!UNdertow.cursorSnap:         False

! set to True to force auto update when doing Zoom Full Size
!UNdertow.autoUpdateOnZoomFull:         False

! set to True to always 'Load Fast' and remove the old vcd file
!UNdertow.alwaysLoadFast:     False

! choose whether you want 'x' or 'line' zoom markers
! 0 = 'x', 1 = 'line'
!UNdertow.markerStyle:   0

! set the integer multiple of how many times taller an analog waveform
! is than a digital waveform
!UNdertow.analogHeightMultiple:         3

! choose if you want to be able to zoom in the horizontal scroll
! bar instead of having smooth scrolling
!UNdertow.scrollZoom:    False

! color for z value
!UNdertow*zColor:        orange

! color for x value
!UNdertow*xColor:        Red

! color for zero value
!UNdertow*zeroColor:          blue

! color for one value
!UNdertow*oneColor:      green

! color for bus value
!UNdertow*busColor:      white

! color for bus text value
!UNdertow*busTextColor:       white

! color for analog waveforms
!UNdertow*analogColor:     white

! color for waveform background for Test Analyzer
!UNdertow*analyzeColor:     plum

! you may also choose colors on a signal by signal basis
! clock would be the name of the signal excluding hierarchy, and you would remove
! the exclamation point and space from the beginning of the line

! UNdertow*clock*zeroColor:   magenta

! colors for the Name/Value popup window
!*NameValuePopup*background:    white
!*NameValuePopup*foreground:    black
!*NameValuePopup*borderColor:   black

! background of wave window
!UNdertow*WaveWindow.background:        grey30
!UNdertow*WaveWindowDummy.background:   grey30

!background of signal name/value window
!UNdertow*SignalWindow.background: grey30
!UNdertow*SignalWindowDummy.background:      grey30

! background of choose button
!UNdertow*choose*background:       SlateGrey

! background of choose window
!UNdertow*ChooseParent*background: SlateGrey

! border color for vertical scrollbar
!UNdertow*DataViewport*scrollbar*borderColor:     white

! border color for horizontal scrollbar
!UNdertow*horizScroll*borderColor: white

! border color for button area in Choose window
!UNdertow*ChooseButton*borderColor:          white

! border color for load time interval portion of Choose window
!UNdertow*ChooseParent*load_time_form*borderColor:     white

! border color for modules label in Choose window
!UNdertow*ChooseParent*label1*borderColor:   white

! border color for module list in Choose window
!UNdertow*ChooseParent*modport*borderColor:       white

! border color for variables label in Choose window
!UNdertow*ChooseParent*label2*borderColor:  white

! border color for variable list in Choose window
!UNdertow*ChooseParent*varport*borderColor:       white

! border color for variable text chooser in Choose window
!UNdertow*ChooseParent*var_text_port*borderColor: white

! border color for additional groups boxes
!*moreg_radio_box.borderColor:     white
!*moreg_group_box.borderColor:     white

! colors for the scrolling arrow buttons
!UNdertow*scroll_up_button*foreground:  black
!UNdertow*scroll_up_button*background:  white
!UNdertow*scroll_down_button*foreground:  black
!UNdertow*scroll_down_button*background:  white
!UNdertow*creepl*foreground:  black
!UNdertow*creepl*background:  white
!UNdertow*creepr*foreground:  black
!UNdertow*creepr*background:  white

! default foreground for unspecified regions
!UNdertow*foreground:         white

! default background for unspecified regions
!UNdertow*background:         black


! signal text widgets backgrounds

! text alignment for signal values
!UNdertow*SignalWindow.value*justify:   right

! font of choice, additional fonts can be found by typing "xlsfonts".
!UNdertow*font: -*-helvetica-medium-r-normal-*-12-*-*-*-*-*-*-*

! font used for signal labels and values
!UNdertow*SignalWindow*font: -*-helvetica-medium-r-normal-*-12-*-*-*-*-*-*-*

! If a smaller signal value font is needed
!UNdertow*SignalWindow*value*font: -*-helvetica-medium-r-normal-*-8-*-*-*-*-46-*-*

! font used for values inside the waveform
!UNdertow*WaveWindow*font: -*-helvetica-medium-r-normal-*-8-*-*-*-*-46-*-*

! font used in the time scales
!UNdertow*Time*font: -*-helvetica-medium-r-normal-*-8-*-*-*-*-46-*-*

! font used for pulldown menu buttons
!UNdertow*ButtonWindow*font: -*-helvetica-bold-r-normal-*-14-*-*-*-*-*-*-*
!UNdertow*ChooseButton*font: -*-helvetica-bold-r-normal-*-14-*-*-*-*-*-*-*

! font used for cursor time values
!UNdertow*ButtonWindow*Label*font: -*-helvetica-medium-r-normal-*-14-*-*-*-*-*-*-*
!UNdertow*ChooseButton*Label*font: -*-helvetica-medium-r-normal-*-14-*-*-*-*-*-*-*

! font used for quick pick buttons
!UNdertow*QuickUIForm*font: -*-helvetica-bold-r-normal-*-14-*-*-*-*-*-*-*

! font used in pulldown menus
!UNdertow*ButtonWindow*SmeBSB*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*SmeBSB*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*

! font used in the output window
!UNdertow*output_ascii*font: -*-clean-medium-r-*-*-13-*-*-*-*-*-*-*

! fonts used for buttons in the pinup menus
!UNdertow*pin_file_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_edit_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_format_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_group_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_options_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_view_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_cursors_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_prefs_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*
!UNdertow*pin_tools_form*Command*font: -*-clean-bold-r-*-*-15-*-*-*-*-*-*-*

! font used for the name/value popup window
!*NameValuePopup*font: -*-helvetica-medium-r-normal-*-12-*-*-*-*-*-*-*

! Bind Keys routines
!
! File menu:
!  Open - commandOpenClose()
!  Close - commandOpenClose()
!  Save - commandSave()
!  Save All - commandSave(All)
!  Restore - commandRestore()
!  Start New Undertow - commandStartNewUndertow()
!  Sync Undertows - commandSyncUndertows()
!  Print Signals - commandPrintSignals()
!  Print Output - commandPrintOutput()
!  Create Fast File - commandCreateFastFile()
!  Create Auxiliary File - commandCreateAuxiliaryFile()
!  Create Reduced File - commandCreateReducedFile()
!  Redraw - commandRedraw()
!  Help - commandHelp()
!  Quit - commandQuit()
!
! Edit menu:
!  Select All - commandSelectAll()
!  Cut - commandCut()
!  Copy - commandCopy()
!  Paste - commandPaste()
!  Paste Blank - commandPasteBlank()
!
! Format menu:
!  Hexadecimal - commandHexadecimal()
!  Binary - commandBinary()
!  Decimal - commandDecimal()
!  Octal - commandOctal()
!  ASCII - commandASCII()
!  Normal - commandNormal()
!  Ones Complement - commandOnesComplement()
!  Twos Complement - commandTwosComplement()
!
! Group menu:
!  Display Group A - commandDisplayGroup(A)
!  ...
!  Display Group Z - commandDisplayGroup(Z)
!  Load Group From File - commandLoadGroupFromFile()
!  Clear Last Group - commandClearLastGroup()
!  Clear All Groups - commandClearAllGroups()
!  Assign Group A - commandAssignGroup(A)
!  ...
!  Assign Group Z - commandAssignGroup(Z)
!  Save Group To File - commandSaveGroupToFile()
!  Additional Groups - commandAdditionalGroups()
!
! Options menu:
!  Choose - commandChoose()
!  Text - commandText()
!  Alias - commandAlias()
!  Auto Update - commandAutoUpdate()
!  Update Signals - commandUpdateSignals()
!  Real Time Mode - commandRealTimeMode()
!  Real Time Interval - commandRealTimeInterval()
!  Time Scale - commandTimeScale()
!  Dump Signals - commandDumpSignals()
!  Dump Signals Tabular - commandDumpSignalsTabular()
!  Dump Groups - commandDumpGroups()
!  Dump Aliases - commandDumpAliases()
!  Dump Names - commandDumpNames()
!  Recall Output - commandRecallOutput()
!
! View menu:
!  Zoom In - commandZoomIn()
!  Zoom Out - commandZoomOut()
!  Zoom Full Size - commandZoomFullSize()
!  Split Signal Viewer - commandSplitSignalViewer()
!  Unsplit Signal Viewer - commandUnsplitSignalViewer()
!
! Cursors menu:
!  Go To Time/Value/Edge - commandGoToTimeValueEdge()
!  Go To Cursor - commandGoToCursor()
!  Fix Cursor - commandFixCursor()
!  Cursor Snap - commandCursorSnap()
!  Grid Signal LE - commandGridSignal(LE)
!  Grid Signal TE - commandGridSignal(TE)
!  Clear Cursors - commandClearCursors()
!
! Scroll menu:
!  Horizontal Scroll - commandHorizontalScroll()
!   Scroll To LE - commandHorizontalScrollToLETE(LE)
!   Scroll To TE - commandHorizontalScrollToLETE(TE)
!   Scroll To Max Time - commandHorizontalScrollToMaxTime()
!   Scroll 90% - commandHorizontalPercent()
!  Auto Scroll - commandAutoScroll()
!  Vertical Scroll - commandVerticalScroll()
!   Scroll Set Interval - commandVerticalScrollSetInterval()
!   Scroll 90% - commandVerticalScrollPercent()
!  Scroll Search All - commandScrollSearchAll()
!  Scroll Search Frequent - commandScrollSearchFrequent()
!
! Tools menu:
!  Test Analyzer - commandTestAnalyzer()
!
! Scrolling controls:
!  Scroll Up Arrow Button - commandArrowUp()
!  Scroll Down Arrow Button - commandArrowDown()
!  Scroll Left Arrow Button - commandArrowLeft()
!  Scroll Right Arrow Button - commandArrowRight()
!
!UNdertow*TopForm.translations:
!Ctrl<Key>a:   commandSelectAll()
!Ctrl<Key>t:   commandCut()
!Ctrl<Key>y:   commandCopy()
!Ctrl<Key>p:   commandPaste()
!Ctrl<Key>c:   commandChoose()
!Ctrl<Key>z:   commandZoomIn()
!Ctrl<Key>o:   commandZoomOut()
!Ctrl<Key>f:   commandZoomFullSize()
!Ctrl<Key>u:   commandUpdateSignals()
!Ctrl<Key>g:   commandGoToTimeValueEdge()
!Ctrl<Key>s:   commandCursorSnap()
!:<Key>A:      commandDisplayGroup(A)
!:<Key>B:       commandDisplayGroup(B)
!:<Key>C:       commandDisplayGroup(C)
!:<Key>D:       commandDisplayGroup(D)
!:<Key>E:       commandDisplayGroup(E)
!:<Key>F:       commandDisplayGroup(F)
!:<Key>G:       commandDisplayGroup(G)
!:<Key>H:       commandDisplayGroup(H)
!:<Key>I:       commandDisplayGroup(I)
!:<Key>J:       commandDisplayGroup(J)
!:<Key>K:       commandDisplayGroup(K)
!:<Key>L:       commandDisplayGroup(L)
!:<Key>M:       commandDisplayGroup(M)
!:<Key>N:       commandDisplayGroup(N)
!:<Key>O:       commandDisplayGroup(O)
!:<Key>P:       commandDisplayGroup(P)
!:<Key>Q:       commandDisplayGroup(Q)
!:<Key>R:       commandDisplayGroup(R)
!:<Key>S:       commandDisplayGroup(S)
!:<Key>T:       commandDisplayGroup(T)
!:<Key>U:       commandDisplayGroup(U)
!:<Key>V:       commandDisplayGroup(V)
!:<Key>W:       commandDisplayGroup(W)
!:<Key>X:       commandDisplayGroup(X)
!:<Key>Y:       commandDisplayGroup(Y)
!:<Key>Z:       commandDisplayGroup(Z)
!<Key>F1:       commandHelp()
!<Key>Help:     commandHelp()

