================================================================
dna2abc: Graphical User Interface
================================================================
dna2abc has a graphical user interface that allows access to
all of the features provided by the dna2abc commands.  The
window contains two pages, one for creating and editing voices,
and one for scanners.  Each page has a list of voices/scanners,
a button to add a new item to the list and one to delete the
selected item.  If a voice/scanner is selected, its name appears
above the list.

The scanners and voices pages each contain one or more sub-pages 
for editing the selected item.  Each sub-page has its own help
file available via the Help menu.

=========
File menu
=========

New:        Delete all the scanners and voices
Open:       Open a .tcl file defining new voices and scanners
Save:       Save the currently defined voices and scanners
            to the open file, as a Tcl script
Save As:    Save to a different file name
Exit:       Exit the application

========
Run menu
========

Run All Scanners
      All defined scanners are run to completion
Run Selected Scanner
      Runs only the scanner currently selected on the
      scanner page

Compute Matches
      In the scanner rules table, compute matches against
      the currently highlighted portions of the test buffers.
      Usually not needed because matches are computed
      automatically, see Options below.
Beautify Rule Table 
      Expand the heights of the rows of the scanners rule table
      to make all of the text visible.

Show Console 
      Display the Tcl command console.

============
Options menu
============

Compute match on each keypress
      If enabled, each time a key is pressed in the scanners
      rule table, matches are recomputed.  If you have a lot
      of complicated regular expressions in your table, this
      may slow down the operation of the interface. 

Multiple-line regular expressions
      If disabled, the return key is disabled in the regular
      expression cells of the scanner rules table, preventing
      multi-line regular expressions from being entered.

Generate .midi file for each .abc file
      If enabled and if the abc2midi program is available,
      generate a .midi file for each voice's .abc when the
      voice is closed (voices are closed automatically 
      when scanner runs are completed).  This is currently
      only implemented for Windows and Linux, change the 
      proc voice-close in voice.tcl to add other OSes.

Restore voice parameters after scanner run
      If enabled, when scanners are run all of the parameters
      visible in the voice parameters page are first saved,
      then restored afterwards.  Otherwise, the parameters
      will remain in whatever state they were left in at the
      end of the run.

Run scanners faster (no display or console updates)
      If enabled, the user interface is disabled while scanners
      are running.  Otherwise, you can watch the voice parameters
      change during the run by looking at the voice parameters
      page.  Disabling this option slows down scanner runs
      significantly.  If your rule scripts output text to the
      console, turn this option off to see each message printed
      immediately.

=========
Help menu
=========

Each menu item opens a new window displaying one of the help
files.  The help files are kept in lib/help below where
dna2abc is installed, they're plain text files that can
be read outside dna2abc.  They are also numbered to indicate
the order in which they should be read.