                 _______________________________________
                |                                       |
                |       Welcome to VEDIT PLUS 5.16      |
                |       For QNX Ver. 4.0 (or later)     |
                |_______________________________________|


Before you get started, please read these notes. Also refer to the file
errata.txt for corrections to the manuals and extensive "release notes".


CONTENTS
--------

* Introduction
* Installation Notes
* Install VEDIT PLUS 5.1
* Download and Install Updates
* Enable Compiler Support
* Enable Color Syntax Highlighting
* Configuration Notes
* Other Notes


Introduction
------------

As a user of QNX 4.0 (or later) you already have our VEDIT text editor.
QNX 4.00 through 4.22 were supplied with VEDIT version 2.3. QNX 4.23 through
4.24 were supplied with VEDIT version 3.2, and QNX 4.25 is supplied with
VEDIT version 5.0 or 5.1.

VEDIT PLUS is a superset of VEDIT and is supplied with three printed manuals
-- the VEDIT User's Manual, the VEDIT PLUS Macro Language Reference Manual
and a small VEDIT PLUS QNX Supplement.

Note:   The text of the VEDIT PLUS QNX Supplement is included in the
        on-line help topics "QNX and "QNXCFG".

Although the VEDIT and VEDIT PLUS manuals are primarily oriented towards
Windows/DOS, this should rarely cause any confusion to QNX users. The file
"errata.txt" lists those few commands (e.g. hardware access) that are not
available under QNX. The on-line help is specifically for the QNX version.


Installation Notes
------------------

VEDIT PLUS is installed into /qnx4/vplus. When a newer version is installed,
the old version is first moved to /qnx4/vplus/vX.XX, where 'X.XX' is the
version number. This way /qnx4/vplus always contain the actual
version of VEDIT PLUS being used.

Since VEDIT PLUS is installed into /qnx4/vplus, while the VEDIT supplied with
QNX is installed into /qnx4/vedit, the two will co-exist. This way you can
continue to use plain VEDIT. (Probably the only reason to use plain VEDIT is
if you have more users than the number of VEDIT PLUS node licenses
purchased.)

NOTES:  QNX versions 4.0 through 4.22 were supplied with VEDIT 2.3 installed
        in /usr/lib/vedit. QNX version 4.23 through 4.24 were supplied with
        VEDIT 3.2 installed in /usr/lib/vedit3. VEDIT PLUS 5.1 will also
        co-exist with these older version of plain VEDIT.

VEDIT PLUS can be quickly installed using the QNX "install" command. The
installation performs these functions:

*  Copies all files to the directory /qnx4/vplus/v5.16 (assuming this is
   VEDIT PLUS 5.16).

*  If /qnx/vplus contains an older version of VEDIT PLUS, it is moved
   to /qnx/vplus/vX.XX, where 'X.XX' is the old version number.

*  Moves all files from /qnx4/vplus/v5.16 to /qnx4/vplus.

*  Creates a symbolic link for each file from /qnx4/vplus/v5.16 to
   /qnx4/vplus.

*  Creates /bin/vp as a link to the executable file /qnx4/vplus/vp.

*  Renames any existing $HOME/.vp.cfg and .vp.key files to .vp.cfg.422 and
   .vp.key.422. Although these files are not used by VEDIT PLUS 5.1, they are
   renamed to prevent confusion. (Otherwise you might think these files are
   being used by the new VEDIT PLUS.)


Install VEDIT PLUS 5.1
----------------------

1.  Insert the VEDIT PLUS distribution disk into the floppy drive.

2.  At the shell prompt, type:

        /etc/install /dev/fd0

    This assumes the disk is in drive A, use "/dev/fd1" if the disk is in
    drive B.

3.  You will only need to press <Enter> several times to complete the
    installation.

    If you purchased additional VEDIT PLUS node licenses, insert them when
    prompted to insert any additional disks.

VEDIT PLUS will be installed as "vp" in order to distinguish it from "vedit"
which is already installed on your QNX system.

Refer to the topic "Installing additional software" in the QNX User's Guide
if the "install" command does not work properly.


Download and Install Updates
----------------------------

Free updates to VEDIT PLUS 5.16 are available on the "UNIX and QNX" page of
our web site at www.vedit.com. The page lists the release date of the most
recent version. You can determine your version's release date by selecting
{HELP, About}. The complete ftp address is:

    ftp://ftp.vedit.com/pub/vplus515.F

After downloading, you can install it with the command:

    /etc/install -u vplus515.F


Enable Compiler Support
-----------------------

The compiler support is implemented as items in the {TOOLS} menu. However, by
default the {TUTOR} menu is displayed in place of the {TOOLS} menu.

You can manually display the {TOOLS} menu with the compiler support items by
selecting {MISC, Load Compiler support}. Similarly, you can switch back to
the {TUTOR} menu by selecting {MISC, Load Tutorial menu}.

Assuming you want the compiler support loaded as the default {TOOLS} menu,
you can make a simple change to the "vprc" startup file.

>>> To enable compiler support as the default {TOOLS} menu:

1.  Edit the "vprc" startup file.

2.  Search for the string "#120 = 0" (without quotes) at the beginning of a
    line.

    Change it to "#120 = 1".

3.  Restart VEDIT PLUS. The {TOOLS} menu should now display the compiler
    support items.


Enable Color Syntax Highlighting
--------------------------------

You might also want to enable color syntax highlighting and template editing.
These features are initially set up in the "vprc" startup file for C.

>>> To enable color syntax highlighting and template editing for C:

1.  Select {CONFIG, Programming, File-type specific config} and set it to
    "7".

2.  Select {CONFIG, Save config} to save the new setting.

    To save this for just the current user, save it into the default
    $HOME/vedit/vp.cfg file.

    To save this as the global default for all users, save it into the file
    /qnx4/vplus/vp.cfg.


Configuration Notes
-------------------

In previous versions of VEDIT, the user's configuration and keyboard layout
files were named .vedit.cfg and .vedit.key (VEDIT PLUS: .vp.cfg and .vp.key)
and were saved in the user's $HOME directory. Beginning with VEDIT and VEDIT
PLUS 5.0, these files are now named vedit.cfg and vedit.key (for VEDIT), and
vp.cfg and vp.key (for VEDIT PLUS), and are saved in the directory
$HOME/vedit. Also, the previous .veditrc or .vprc file is no longer used.

As before, these files are automatically loaded at startup (via the veditrc
or vprc file). The function {CONFIG, Save config} normally saves to the file
$HOME/vedit/vedit.cfg and the function {CONFIG, Keyboard layout, Save layout}
normally saves to the file $HOME/vedit/vedit.key. The directory $HOME/vedit
is automatically created, if necessary.

The $HOME/vedit directory is referred to as the "User Configuration
Directory". It is set by the veditrc or vprc startup file. If desired, you
can modify the veditrc or vprc file to select a directory other than
$HOME/vedit. Be sure that each user has read/write access to the selected
directory. See the veditrc or vprc file for details.

The configuration is described in detail in the on-line topics "QNX" and
"QNXCFG". In VEDIT, press <F1>, select [T]opics and enter "QNX".


Other Notes
-----------
Here are other issues you should be aware of:

1.  The key <Numpad *> is not available under QNX. Therefore, only <F11>
    is assigned to {BLOCK, Insert register}.

2.  The keys <Shift-Del> and <Shift-Ins> are not available under QNX.
    Therefore, <Ctrl-C>, <Ctrl-X> and <Ctrl-V> are used to copy/cut/paste
    the VEDIT scratchpad.

3.  The keys <Alt-0> thru <Alt-9> and Alt-punctuation such as <Alt-=> and
    <Alt-.> are not available under QNX.

4.  The Photon clipboard is not yet supported.

5.  VEDIT for QNX does not support "<Shift> block highlighting", i.e. you
    cannot highlight a block by holding down the <Shift> key. Although it is
    impossible to implement this with remote terminals, we hope to implement
    this in the future on the main console.

6.  VEDIT for QNX does not support "Alt/Ctrl/Shift key shortcuts", i.e. you
    cannot access the main menu by just tapping the <Alt> key.
