CONTENTS

 -- Layout of keyboard when using Ved or XVed
 -- Keyboard actions
 -- -- Function Keys on the top row
 -- -- Named and Arrow Keys to right of alphabetic keys
 -- -- Numeric Keypad Keys
 -- Additional functions
 -- The editor is programmable (in Pop-11)

-- Layout of keyboard when using Ved or XVed --------------------------

In what follows it is assumed that you are using a keyboard with the
standard configuration, now found on most PC keyboards, and many others
(e.g. NCD Xterminals), containing:

    1. On the top row, function keys labelled F1, F2, ... F12

    2. A standard alphanumeric collection of keys, with space bar below,
       shift keys, ESC, Tab, Control and CapsLock keys (usually on left,
       some possibly duplicated on the right), and on the right BackSpace
       and RETURN.

    3. An "arrow" keypad with four arrow keys, and above it six keys
       arranged in two rose,

    4. A numeric keypad on the right with "-" on top right, "+" below
       it, ENTER below that, and at the bottom "0/Ins" and "./Del" keys.

    5. If you are using a Sun workstation there may be an additional
       keypad on the left, in two columns of 5 keys.
        ----------------------------------------  ----------
        |    1  Function keys                  |  |not used|
        ----------------------------------------  ----------

        ----------------------------------------  --------- -----------
        |                                      |  | keypad| |         |
        |    2  Main key board                 |  --------- |4 numeric|
        |                                      |     3      |  keypad |
        |                                      |  --------- |         |
        |                                      |  | arrows| |         |
        ----------------------------------------  --------- -----------
(The above will display badly if you don't allow fixed-width fonts.)

The four sets of keys shown work the same in VED, on NCD X terminals, on
PCs used as Xterminals or PCs running linux, on Digital Alpha
workstations, and on Suns with "type-5" keyboards.

The numeric keypad should be configured to transmit function codes not
the numeric and arithmetic symbols printed on the keys. This should
happen automatically.

The ENTER key on the numeric keypad should in that case transmit
different codes from the RETURN key on the main keyboard, as Ved and
XVed use them for different purposes. If for some reason the ENTER key
is not working, use ^G (CTRL G) as ENTER.

If you have three keys to the left of the Space bar, they may be
labelled Ctrl, Window (with a picture), and Alt (or Meta). In that case
you may find that the Window key also works as an ENTER key.

(You may find that you have additional keys that are not used. If you
wish to use them you may find it useful to get the free software package
xkeycaps to configure them. However that is beyond the scope of this
file.)

Besides using special function keys to drive the VED editor, you can
also use "key sequences" described in HELP VEDKEYS. Those should work no
matter which keyboard you are using.


-- Keyboard actions ---------------------------------------------------

-- -- Function Keys on the top row

The lower line gives the functions associated with each key on its
own. The upper line gives the functions associated with ESC followed by
the key.

     (Note: "linepart" means most recently deleted part line segment.)

        F1       F2       F3       F4       F5        F6       F7
     +--------+--------+--------+--------+--------+--------+--------+
 Esc | mk top | mk end | yank   | yank   | yank   | yank   | yank   |
+Key | file   | file   |linepart| line   |linepart|linepart|linepart|
-----+--------+--------+--------+--------+--------+--------+--------+
 KEY | MARK   | MARK   | DELETE | DELETE | DELETE | DELETE | DELETE |
     | BEGIN  | END    | LINE <-| LINE   | LINE-> | WORD <-| WORD-> |
     +--------+--------+--------+--------+--------+--------+--------+

         F8       F9      F10      F11      F12
     +--------+--------+--------+--------+--------+
 Esc | move   | copy   | move   | POP    |Clear   |   The last two
+Key | in     | in     | out    |        | Mark   |   may be different
-----+--------+--------+--------+--------+--------+   on some
 KEY | MOVE   | COPY   |XREFRESH| PUSH   | XCHANGE|   keyboards.
     | RANGE  | RANGE  |(file?) |        | POSN.  |
     +--------+--------+--------+--------+--------+
NOTE: In XVED F10 will set up "File" options, so it cannot be used.


-- -- Named and Arrow Keys to right of alphabetic keys

       KEY                                 Esc+Key

    +--------+--------+--------+       +--------+--------+--------+
    |TOGGLE  | TOP OF | LAST   |       | line   |go start| xup    |
    | STATIC | FILE   | WINDOW |       | above  |of range|        |
    +--------+--------+--------+       +--------+--------+--------+
    | DELETE | END OF | NEXT   |       |        |goto end| xdn    |
    | CHAR < | FILE   | WINDOW |       |        |of range|        |
    +--------+--------+--------+       +--------+--------+--------+


             +--------+                         +--------+
             | CHAR   |                         | Up     |
             | UP     |                         | lots   |
    +--------+--------+--------+       +--------+--------+--------+
    | CHAR   | CHAR   | CHAR   |       | Left   | Down   | Right  |
    | LEFT   | DOWN   | RIGHT  |       | Lots   | Lots   | Lots   |
    +--------+--------+--------+       +--------+--------+--------+

Sometimes ESC followed by arrow may have a different effect, depending on the
keyboard: try it out.


-- -- Numeric Keypad Keys

Note "<" means "left" and ">" means "right"

       KEY                                     Preceded by ESC
                                             (first three columns only)
    +--------+--------+--------+--------+   +--------+--------+--------+
    |        | HELP   | LOAD   | REDO   |   |        | help   | load   |
    |        |XTRMKEYS| LINE   |        |   |        | on key | range  |
    +--------+--------+--------+--------+   +--------+--------+--------+
    | CHAR   | CHAR   | CHAR   |        |   | up     | up     | up     |
    | UP <   | UP     | UP >   | SWITCH |   | < lots | lots   | > lots |
    +--------+--------+--------+ STATUS |   +--------+--------+--------+
    | CHAR   | 5      | CHAR   |        |   | left   | 5      | right  |
    | LEFT   |        | RIGHT  |        |   | lots   |        | lots   |
    +--------+--------+--------+--------+   +--------+--------+--------+
    | CHAR   | CHAR   | CHAR   |        |   | down   | down   | down   |
    | DOWN < | DOWN   | DOWN > |        |   | < lots | lots   | > lots |
    +--------+--------+--------| ENTER  |   +--------+--------+--------+
    | WORD LEFT       | WORD   |        |
    |                 | RIGHT  |        |  (NB. lots = a third of window)
    +-----------------+--------+--------+

The 5 key may be given a function in some keyboard configurations and not in
others. Try it. It should normally default to vedmidwindow, which moves
the current line (where the ved cursor is) to the middle of the window,
showing context above and below.

-- Additional functions -----------------------------------------------

Some additional functions are provided in LIB * VEDXTERMKEYS

These two make it easy to move or copy the marked range in the current
file (the mnemonic should be obvious);

    ESC -
        keep one copy of marked range and move it here

    ESC =
        make two copies, by copying to here

    CTRL L
        Invokes vedxrefresh. Before refreshing the screen this procedure
        finds out if the xterm window has been re-sized and if so
        re-sets linewidth and window length accordingly.

    ESC Delete
    ESC BS
        This will invoke vedjoinline, which joins the current line to the
        previous line, no matter where the cursor is, and no matter whether
        this violates vedlinemax. Often useful when re-formatting.

    The variable vedexpand now defaults to the character `^` instead of
    to false. See HELP * vedexpand

See also HELP * VEDKEYS

-- The editor is programmable (in Pop-11) -----------------------------
Because the editor is implemented in pop11 it can be extended and
modified by a pop11 programmer. E.g. I use the editor to insert html
tags in web files, using programmed extensions.

However it is not compulsory to use the editor. If you prefer to use
another text editory you can copy and paste code to the pop11 command
line, or edit a file, save it, read it into Ved or XVed and then give
the command to compile (=load) the current file (ENTER l1), or to
compile all files currently in the editor (ENTER l)