               How to operate the wheel template editor
               ========================================
	       
The wheel template editor is designed to make the creation of wheel templates
as painless as possible.  There are three reasons for opening the wheel
template editor:

1. There is a wheel file for which no wheel template exists, and a new
   wheel template needs to be written for it.
 
2. A wheel template needs to be updated, since it does not translate
   some wheel correctly.
   
3. Curiosity.

How to write a new wheel template
---------------------------------
1. Bring the wheel file that needs to be translated into the example portion
   of the wheel template editor window.  This may be done in two fashions:
   
   A. Opening the wheel template editor from the automatic input window by
      ``create wheel template'' for a specific file.
   B. Choosing ``Example...'' --> ``Import...'' from the menubar of the wheel
      template editor, and choosing the file.
      
2. Copy the headline of the wheel into the ``headline'' portion of the
   wheel template editor window.
   
   This may be done by copy/paste using the mouse, or by manually typing in
   the line into the headline portion.  The headline for each example should
   be the contents of exactly one line of the wheel.  A line which appears
   in all wheel files of the same format.  If the wheel has no such line,
   then the "KEYWORDS" option should be used.  See ``Help...'' --> 
   ``Templates..'' for more information on "KEYWORDS".
   
3. Write the header portion of the template.

   This may be done by choosing ``File...'' --> ``Append...'' the file
   ``header''.  This will copy a default header into the template section
   of the wheel template editor.  The values given should be adjusted
   to match the properties of the wheel file.
   
4. For each aperture type in the wheel, write a record in the template.

   One way of doing this is by choosing  ``File...'' --> ``Append...''
   and the file whose name matches the aperture type in the wheel file.
   The lines added must then be adjusted to match the format in the
   wheel file.  For information on the meaning of these lines, see
   ``Help...'' --> ``Templates..''
   
5. Test that the template successfully translates the wheel.

   This is done by choosing, ``File...'' --> ``Run''.  Unless you are very
   skillful, and very lucky, the first time you do this operation, you
   will be given an error message, and the offending line will be lit.

6. Save the template

   Choose ``File...'' --> ``Save...'' and then give the template a new name
   
   
How to update an existing template
----------------------------------

1.  Import the new wheel as a new example.

    This may be done by choosing ``Example...'' --> ``Import...'' from the 
    menubar of the wheel template editor, and choosing the file.

2.  Update the template to accomodate the new wheel, making sure not to
    impair its ability to translate the other examples.
    
3.  Run the translation on the new example, making sure that
    the translation is correct.

    This is done by choosing, ``File...'' --> ``Run''.
    
4.  Run the translation on each of the other examples, making sure that
    the translations remain correct.
    
    Choose the other examples by choosing, ``Example...'' --> ``Previous''
    and then running the translation on the current example.
    
5.  Save the updated wheel template.

    Choose ``File...'' --> ``Save...'' and keep the same template name

    

Ben Michelson
Valor Computerized Systems Ltd
20 Jul 95
