#HT Help# HT 1 1 24 80 0 15
Ctrl C to exit program quickly.
To exit any window (including this one)
   hit Escape
To scroll the text in the window use
   Page up          Page down  (can be activated by mouse)
   SHIFT+Up arrow   SHIFT+Down arrow (SINGLE line scrolling)
To pan left or right
   Ctl + left  arrow  and    Ctl + right arrow   
To move around HyperText buttons use
   down or right arrow   for the next one
   up or left arrow      for the previous one
To view more detail about the current (highlighted) button
   hit enter 
To print the entire HyperText card
   hit F2
   
TRY any other FUNCTION keys displayed on the screen.

To view HyperText with a mouse
   click the left mouse button on any HyperText button to view it,
   click any object on the bottom line for other actions.

#Pick Help# HT 1 1 24 80 0 15
Ctrl C to exit program quickly.
To abort the selection
   hit Escape
To scroll the text in the window use
   Page up          Page down
   SHIFT+Up arrow   SHIFT+Down arrow (SINGLE line scrolling)
To move around items use
   down or right arrow   for the next one
   up or left arrow      for the previous one
To select the current (highlighted) item
   hit enter 
To print the entire list of selections
   hit F2
Any other active function keys are shown at the bottom of the screen.

To view with a mouse
   to select an item, click left on it,
   click any object on the bottom line for other actions.
   
#Data Entry Help# HT 1 1 24 80 0 15 
Ctrl C to exit program quickly.
To exit
   hit Escape
To enter a value
   Just use the keyboard normally, what you see is what you get.
   Insert toggles insert/replace mode. 
             (Insert state and availabiity shown on bottom screen line)
   You may use the numeric keypad.
   Enter validates and transmits the value shown. 
To move between fields
   Enter automatically validates and then moves to the next field
   To shift between fields
     use Control+left to go backwards
     or Control+right to go forwards
     or select another field with the mouse.
To move down or up a line in the data
   Use up and down arrow keys
To move down a page
   Use Page up and Page Down
To pan left or right
   Shift + left  arrow
   Shift + right arrow   
Insert and delete line  (Available if shown as function keys)
   Use the function keys as defined on the bottom line of the screen.
   On insert, the new line goes after the current line except 
      that if you are in the top left hand corner a new line is 
      inserted as the first line.
   Note that when a line is inserted, you are required to "enter" 
   values across the entire line before you can leave the line, 
   save the file or print the file.

All functions shown on the bottom line can be activated by clicking
there with the left mouse button.
The mouse can also be used to select the next field to edit and
for moving between screens in split screen edit mode.

#Custom Data Entry Help# HT 1 1 24 80 0 15 
Ctrl C to exit program quickly.
This screen has been custom designed to display and edit data

When you have finished entering values
   hit Escape
To enter a value
   Just use the keyboard normally, what you see is what you get.
   Enter transmits the value shown.
To move between fields
   Enter automatically validates and then moves to the next field.
   Enter from the last field moves to the first.

Entering a character at the start of the field blanks out the field.
   
Backspace works normally.
Left and right arrow keys work normally.
   
If your entry is unacceptable, the original value will be restored.

The mouse can be used to select actions as displayed on the bottom 
row of the screen.
      
#Graphics Help# HT 1 1 24 80 0 15     
        Scrolling Keys                Function Keys
  PAN                    ZOOM
                                      F1  Display this Help Panel
Up           LEFT        <-           F2  Hyper Control
Down          UP         ->           F3  Information about all trains
PgUp       Big LEFT      Ctrl <-      F4  Let simulation run without pausing
PgDn       Big RIGHT     Ctrl ->      F5  Pause after next event
Ctrl Home  LEFT MARGIN   Home         F6  Set Simulation Interrupts
Ctrl End   RIGHT MARGIN  End          F7  Automatic ZOOM centering
                                      F8  Toggle ZOOM display On/Off
  Esc Abort Simulation Graphics       F9  Display most recent messages
                                      
#HT EDIT Help# HT 1 1 24 80 0 15 
Ctrl C to exit program quickly.
You may be editing a function or a Hypertext card.
The following keys behave as expected:-
  right arrow,  left arrow,
  backspace,    delete, 
  page up,      page down,
  Ctrl Pge Up,  Ctrl Pge Dn,
  insert.

HOME/END place the cursor at the start/end of the current line, panning if
  necessary.
CTRL HOME/END  places the cursor at the start/end of the document.

Esc prompts for save if there are changes, and exits.
F4 saves the edited card in its original position in the file.

Other active function keys are shown on the last screen line.
In particular, if you are editing a function the F9 key places you
in the documentation in browse/clipboard mode.

In general, when the F8 key is displayed, you can insert lines from the
clipboard.

#Clipboard Help# HT 1 1 24 80 0 15 

  F2 shows the clipboard,
  F3 deletes the clipboard,
  F6 toggles the highlighting of the current line (marks the line),
  F7 copies all highlighted lines to a file called "clipboar",
     and removes the highlight from the lines;
     these lines are available for insertion into a file whenever the
     F8 - "from Clipboard" function key is active.
     
  In DOCAID this feature can be used to selected lines from
  the analysis that you wish to copy into the function itself
  (presumeably as comments).
  
#HELP Colour Definition# HT 2 1 22 57 0 15
For Help with the mechanics of changing data values,
  see #*Data Entry Help*# 

As you change colour data values, the panel on the right
shows you what the various screen items will look like.
  
For help with the meaning of these items,
  see #*Use of Colour in HYCOM*#
  
The lower line on the screen shows the colors represented
by each of the numbers.  

For a tabular listing, see #*Colour Table*#.

Note that on LCD screens, "colours" are represented by 
various shades of grey AND various type fonts.  The file 
colors.lcd is a good starting point for a usable suite of
colours.

#Use of Colour in HYCOM# HT 2 1 22 57 0 15
Hypertext Colours (Active Button and Inactive buttons) 
are used for the colour of buttons.
The colours for display of the text in the card is taken
from the card itself.  This includes all Help cards. 
Such colours can be overridden by entries other than -1 
in the Special Items - External HT files (see below).

Data Editing colours (Edit Field, Other Data Fields, and
Headings) are used when editing database tables, such as
HYCOLOR.DAT.

Custom Data Panels provide for specialised entry of
non-tabular data.  In DOCAID, the only use of these is in
requesting Yes/No responses from the user.  You may want to
change the colours here to adjust the contrast between
these panels and their background.  To do so, experiment
with the values for Text Fields, Data Fields, and Field 
in Edit.

Three types of messages to the user (OK, USER and
SERIOUS) may appear in boxes.  All require a response
(Ctrl C to exit, any other key to continue.  We hope that
you never see a "Serious message" - they indicate program
problems.  They are distinguished by the colour of the
box (specified here), and a beep.

Programs in the HYCOM set use the top and bottom screen
lines for titles, progress messages and minor error
notification, and the display of active function keys.
You can adjust the foreground and background colours in
Top line, Bottom line and Function keys.
As well, a Ticker and Memory count appear towards the
right of the bottom screen line.  Both are mostly useful
for debugging programs in HYCOM, or to entertain you
during long program runs. (Memory count is the amount of
heap memory that remains available to the program).
Both can be made invisible by specifying the same colours
as for the "bottom line".
  eg. Ticker:  Foreground 2   Background 2

Program-generated reports (including the documentation
output of DOCAID) use the foreground and background
colors from Generated reports.

Normally, HyperText cards (hand-crafted or computer-
generated) are displayed in the colours specified on the
card itself.  The "External HT files", if specified, will
override the card colours.  To allow the card colours on
the card itself to display, leave the "external colors"
as -1, -1.

Pick Documentation colors are used when the documentation
is viewed in pick mode, to select lines for the clipboard.
Edit C function colors are used when you bring a C
function into edit mode, or a module into view mode.

#Colour Table# HT 2 1 22 57 0 15
  Black          0
  Blue           1
  Green          2
  Cyan           3
  Red            4
  Magenta        5
  Brown          6
  Light grey     7 
  Dark grey      8
  Light blue     9
  Light green   10
  Light cyan    11
  Light red     12
  Light magenta 13
  Yellow        14
  White         15
  Underline      1 (monochrome only)
  