┌───────────────────────────┐
 │ SIMON the resident editor │
 └───────────────────────────┘
 by Clockwork Software.

   SIMON is so simple and offers so much built-in help that you hardly
   need a handbook. These few pages act as an introduction and cover the
   major points.

INSTALLING SIMON

   SIMON is on a single file: SIMON.COM. Copy it to your hard disk or
   working disk with the command:

              COPY a:SIMON.COM   c:

   The setup routines for selecting default values for colours, buffer
   size, file specification, line length etc are all built into SIMON.COM
   itself - there is no need for a separate setup or install program. The
   KEEP command causes setup details to be copied from the resident
   program back to the SIMON.COM file.

REVIEW VERSION

   The review version of SIMON is identical to the real one, but it
   includes Nigel, a salesman on the staff at Clockwork, whose job is to
   persuade you eventually to buy a copy of SIMON for yourself.

   You are welcome to pass on copies of this program to friends and
   colleagues so long as Nigel has not been disabled.

LOADING SIMON

   Load SIMON with the command:

        SIMON    or    SIMON [n][/i][/p][/u][/m-][filespec]

   The parameters are all optional and can be given in any order.

   * The buffer size parameter n should be a decimal number in the range
     4 to 64. (Silly numbers are ignored by SIMON)

   * The install only switch /i tells SIMON to install itself, but to wait
     for you to press the hotkey before starting work.

   * The protected mode switch /p protects SIMON against accidental
     uninstalling by disabling the Alt_X command. You can still
     uninstall through the pull down menu, and also by executing SIMON
     again with the /u switch.

   * A /u switch tells SIMON to search for an already resident version of
     the program, and instructs it to uninstall itself forthwith.

   * The character following the /m switch is used as a new margin
     indicator. The new margin character is made the default by the KEEP
     command.

   * If you give a filespec then SIMON will start work by loading your
     file, or listing all the files which match your filespec.

   If no filespec is given the SIMON starts by showing a page which
   contains some useful information about SIMON's status.  You can then
   press Alt_N for new-file or F3 to load an existing file from disk.

   The file buffer will always be between 4k and 64k in size. If you don't
   give a buffer size then SIMON will use its default value. The default
   buffer size is set with the KEEP command.

   With a buffer of 4k, which is big enough for most small editing jobs,
   SIMON occupies a mere 39k of RAM, which you would scarcely miss. With
   a buffer of 64k SIMON occupies about 99k of RAM.

   While it is on the screen SIMON can be dismissed with the hotkey(s),
   with F9(dismiss) or F10 (save and dismiss), and called forward again
   with the hotkeys (initially F9, but user selectable).

UNINSTALLING

   SIMON is just as easy to uninstall - press Alt_X.  SIMON won't mind,
   and won't harm, other programs running above it when it uninstalls,
   unless it is trapped by another TSR which has been installed
   subsequently.

   If trapped, SIMON will offer to remove everything above itself and
   restore vectors to pre-SIMON values. This powerful process is likely
   also to remove any program which is running above SIMON, so accept
   this option with caution.

HOTKEYS

   The hotkey combination which calls SIMON can be changed as often as you
   wish (Esc_O_H), perhaps to avoid clashes with the foreground activity.
   Any combination of a shift-key (Lshift, Rshift, Ctrl, Alt or no-shift)
   and one other key will do.

   It is quite easy to forget your newly changed hotkey combination. If
   SIMON is working at the time then the options menu will remind you.
   Otherwise execute SIMON again. It will call itself and remind you what
   the current hotkeys are.

   Your hotkeys are saved as defaults by the KEEP command.

HELP

   Four levels of help are provided:

   * The prompt line at the screen bottom is live, and list many of the
     options available.

   * A crib listing all the commands can be called to occupy the right of
     the screen (reducing the screen width to 55 characters). Grey+ and
     Grey- call the crib and scroll it in either direction. Esc hides it
     again.

   * If not cancelling some other activity, Esc will call a comprehensive
     pull-down menu system. Most commands are available through the pull
     downs, which also remind you of the more direct key-sequences.

   * Some 20 or so descriptive help pages are available by pressing F1 (so
     long as SIMON.COM can be found in the same directory as it was
     loaded from). An ASCII character table is included in the help.

FILE/DIRECTORY SELECTOR

   Function F3 (load file) and Alt_I (insert file) both ask you for a file
   specification and then engage a powerful file selector routine. If your
   specification is broad enough("*.*") to include subdirectories then
   they are listed above the files. You can jump into any subdirectory or
   back up the path to the root directory very rapidly.

   Your file specification is saved as default by the KEEP command.

COLOURS

   SIMON has a very friendly colour selector, available (Esc_O_S) if
   SIMON.COM is still in the drive from which it was loaded . All the
   colours are individually selectable, but you may use any of the four
   standard colour schemes as your starting point. Your colour selection
   is saved with the KEEP command.

BOXES/LINES

   Lines and boxes can be drawn in any of 8 different styles (Alt_T).
   If you select one of the single or double border styles then SIMON
   will attempt to link it with border characters already on the screen.

COLUMN BLOCKS/GRAB

   SIMON can handle two kinds of blocks. The conventional block is defined
   by a start mark (F7) and an end mark (F8). Everything in the file
   between the start and end is the block, which can be:
                * copied           Alt_C
                * moved            Alt_M
                * deleted          Alt_D
                * made uppercase   Ctrl_K_U
                * made lowercase   Ctrl_K_L
                * capitalised      Ctrl_K_I
                * words counted    Ctrl_K_N

   The second type of block is a column (rectangular) block. SIMON calls
   the process of reading in a column block, either from the current
   (SIMON) screen or from the background screen, a GRAB (F5). Column
   blocks are stored in a clip-board and can be pasted repeatedly at the
   cursor (Shift_F5).

   The clip-board buffer storing the column blocks is alsoused for many
   other purposes, principally file selection and help, so do not assume
   that the contents of the clip-board will remain available for ever.

PRINTING

   SIMON will print (Alt_P):
                * The whole file
                * The currently marked block
                * A message to be typed through the keyboard
                * A form-feed (eject)
                * Optionally adding line-numbers

   Control characters can be typed into the file either using the Ctrl_P_?
   to enter a keystroke (such as Esc) literally. Alternatively you can
   type the ASCII number while holding down the Alt key. Your printer
   manual will tell you which control characters to send.

   There are 6 printer ports to which printing data can be sent. Select
   the port with Alt_P, or Esc_P. Your selected port is saved with the
   KEEP command.

AUTO-INDENT/LEFT MARGIN

   Auto-indent is the default condition, i.e. each new line is indented
   the same as the one above unless you direct the cursor elswhere.

   Setting a left margin cancels auto-indent. The left margin is set by
   moving the cursor to the correct column and pressing Shift_F3. The
   margin area is indicated by the display of dots where there ought to
   be spaces. You can type within the left margin, but it acts as a guide
   to the cursor when you create a new line.

   You may cancel the left margin and reinstate auto-indent by setting
   the margin back to the leftmost column.

LINE-LENGTH/RIGHT MARGIN

   SIMON's line length is 64,000 characters.

   You can set a right margin at the cursor position by pressing
   Shift_F4. The right margin is indicated by dots.

   SIMON does not mind text outside the margins. The function of the
   right margin is to tell the cursor when to do a wordwrap. To defeat
   word-wrap, set the right margin back to the leftmost column.

RE-FORMAT

   The reformat command Ctrl_B tells SIMON to make the current line
   conform to the present margins either by borrowing text from the
   following line, or by carrying the surplus forward. It works on one
   line at a time for greater control.

   Margin settings are saved as defaults by the KEEP command.

EXPAND/COMPRESS

   Some editors and wordprocessors compress files by converting multiple
   spaces to tab characters, chr(9). These display as small circles on
   the screen.

   You can ask SIMON to expand all tab characters in the file by setting
   the Expand mode switch (Esc_O_E).

   You can also ask SIMON to compress multiple spaces to the appropriate
   tab characters on saving a file. The Compress mode switch is set by
   (Esc_O_C).

   The state of the Expand mode and Compress mode switches is saved with
   the KEEP command.

BACKUP FILES

   If Backup mode is on then a file is backed up before it is saved.
   This adds security but takes additional time in disk access. The
   Backup mode option is set by (Esc_O_B). The Backup mode is saved as
   default by the KEEP command.
MACRO COMMANDS

   Repetitive editing jobs often can be speeded by the use of macro
   commands. You simply ask SIMON to watch while you perform a key
   sequence. SIMON will then repeat the sequence, exactly, when you ask.

   SIMON has ten macros (Alt_0 to Alt_9). The macro buffer will hold a
   total of 250 key-strokes.

   Press Ctrl_M to view the macros or to start learning.

   Macros are saved for future use by the KEEP command.

GRAPHIC SCREENS

   SIMON has been told to break through any current foreground activity
   whenever it detects its hot keys being pressed. However some special
   graphic applications such as GEM and Windows seem unable to restore
   their display properly after interruption.  You will soon learn which
   applications are best not interrupted by calling SIMON.

KEEP

   A block of data, including colours, macros, linelength, hotkeys, file
   specification, buffersize and switch settings are saved to SIMON.COM
   when you ask for KEEP (Esc_O_K). SIMON.COM must be available in the
   directory from which it was loaded for the KEEP command to succeed.


                             ╔══════════════════╗
                             ║ EDITING COMMANDS ║
                             ╚══════════════════╝
   In order that SIMON should be instantly familar to most users, many
   commands can be achieved by alternative key sequences and these are
   listed below. The first mentioned is the preferred sequence and the one
   listed in the crib.


CURSOR MOVEMENT ----------------------------------------------
         Up                      Up-arrow     or   Ctrl_E
         Down                    Down-arrow   or   Ctrl_X
         Left                    Left-arrow   or   Ctrl_S
         Right                   Right-arrow  or   Ctrl_D
         Scroll up               Ctrl_Z
         Scroll down             Ctrl_W
         Scroll up 20            PgUp         or   Ctrl_R
         Scroll down 20          PgDn         or   Ctrl_C
         Word left               Ctrl_left    or   Ctrl_A
         Word right              Ctrl_right   or   Ctrl_F
         Start of line           Home         or   Ctrl_Q_S
         End of line             End          or   Ctrl_Q_D
         Top of page             Ctrl_Home    or   Ctrl_Q_E
         Bottom of page          Ctrl_End     or   Ctrl_Q_X
         Top of file             Ctrl_PgUp    or   Ctrl_Q_R
         End of file             Ctrl_PgDn    or   Ctrl_Q_C
         Tab right               Tab          or   Ctrl_I
         Tab left                Shift_Tab
         Jump to line No         Ctrl_J
         To block start          Shift_F7     or   Ctrl_Q_B
         To block end            Shift_F8     or   Ctrl_Q_K
         To remembered place     F6

BLOCK COMMANDS  ----------------------------------------------
                        Ordinary (linear) blocks:
         Mark start of block     F7           or   Ctrl_K_B
         Mark end of block       F8           or   Ctrl_K_K
         Copy block              Alt_C        or   Ctrl_K_C
         Move block              Alt_M        or   Ctrl_K_V
         Delete block            Alt_D        or   Ctrl_K_Y
         Hide/show block         Alt_H        or   Ctrl_K_H
         Uppercase block         Ctrl_K_U
         Initialise block        Ctrl_K_I
         Lowercase block         Ctrl_K_L
         Number-of-words         Ctrl_K_N
         Write block to file     Alt_W        or   Ctrl_K_W
         Insert file             Alt_I        or   Ctrl_K_R

                        Rectangular (column) blocks:
         Grab block              F5
         Paste block             Shift_F5

FILE  ----------------------------------------------
         Save file               F2           or   Ctrl_K_D
         Load file               F3
         Rename file             Alt_R
         New file                Alt_N
         Insert file             Alt_I        or   Ctrl_K_R
         Dismiss                 F9           or   hotkey
         Save file and dismiss   F10
         Uninstall               Alt_X

ACTIONS  ----------------------------------------------
         Find                    Ctrl_Q_F
         Find and replace        Ctrl_Q_A
         Repeat last find        Ctrl_L
         Delete line             Ctrl_Y
         Delete to line end      Ctrl_Q_Y
         Duplicate line          F4
         Draw boxes/lines        Alt_T
         Reformat line           Ctrl_B
         Macro learn             Ctrl_M
         Perform macro0          Alt_0
         Perform macro9          Alt_9
         Set left margin         Shift_F3
         Set right margin        Shift_F4
         Make uppercase          Alt_U
         Make lowercase          Alt_L
         Literal input           Ctrl_P
         Stamp Name-of-file      Ctrl_Q_N
         Stamp Month-string      Ctrl_Q_M
         Stamp Time/date         Ctrl_Q_T
         Remember place          Shift_F6

PRINT ----------------------------------------------
         Print file              Alt_P_F
         Print block             Alt_P_B
         Print message           Alt_P_M
         Eject page              Alt_P_E
         Select Printer Port     Alt_P_P

HELP  ----------------------------------------------
         Show crib, scroll up    Grey+
         Show crib, scroll down  Grey-
         Hide crib               Esc
         Call Menu               Esc
         Help pages              F1

OPTIONS  ----------------------------------------------
         Tab size                Esc_O_T
         Hotkeys                 Esc_O_H
         Expand tabs switch      Esc_O_E
         Compress spaces switch  Esc_O_C
         Backup files switch     Esc_O_B
         Select colours          Esc_O_S
         Keep options            Esc_O_K