        ͻ
            WELCOME TO THE VEDIT 6.1 DOS TRIAL VERSION    01/29/03
        ͼ

This file describes the trial version of VEDIT for DOS. The Windows
95/98/ME/NT/2000/XP version is available on our Web site at www.vedit.com.

Notes:  For the latest VEDIT trial version (especially if the date above
        is more than 6 months old) please access our Web site.

        The VEDIT trial version can be converted to the full product by
        purchasing the software and entering the serial number at the startup
        prompt.

        To print this file, give the DOS command:

                vedit -z -x print trial-d.txt


Installation
------------

The file READ-DOS.TXT describes how to install and get started with the DOS
version of VEDIT. It includes step-by-step directions for adding a Windows
95/98 icon (shortcut) for DOS VEDIT.

Note: The installation does not change your CONFIG.SYS or AUTOEXEC.BAT files.


Uninstalling VEDIT
------------------

>>> To manually remove (uninstall) VEDIT:

1.  Delete all files from the directory into which you installed the VEDIT,
    by default "c:\vedit".

2.  Remove the VEDIT directory, e.g. "c:\vedit".

3.  If you added any VEDIT icons to your Windows desktop, delete the icons.


Limitations of the VEDIT Trial Version
--------------------------------------

The VEDIT Trial version is fully functional with these exceptions:

*   Each time it is run, you are limited to 2000 keystrokes. You must then
    exit, which will let you save or abandon your changes.

*   Any changes you previously made to the configuration and keyboard layout
    are not automatically loaded at startup. (Technically, the VEDIT.CFG and
    VEDIT.KEY file are not automatically loaded as in the full product.)

As an alternative to the trial version's 2000 keystroke limit, you can run it
with unlimited keystrokes, but then cannot save files larger than a (tiny)
2000 bytes. The Tutorial runs in this mode. This mode can be selected with
the "-d" invocation option.

The VEDIT Trial version for Windows is fully functional for 30 days.


Running the VEDIT Tutorial
--------------------------

We suggest running the extensive Tutorial first. One window displays
directions while you edit sample files. General editing, programming, word
processing, data/binary file editing, and much more, are all covered. A quick
overview takes about 20 minutes; running through the tutorial step-by-step
will take several hours, but will make you a very proficient VEDIT user.

To run the Tutorial, select the items in the {HELP, Tutorial} menu. We
suggest running them from top to bottom because the topics often build
on previous topics.

Note:   As a convenience to new users, the tutorial topics are also
        available in the main {Tutorial} menu when VEDIT is running
        as a trial version.


Running VEDIT
-------------

The file READ-DOS.TXT describes how to run and get started with VEDIT.

The trial version is "nearly" fully functional; its limitations are described
below. In short, start VEDIT with the command:

        vedit filename      (also multiple files, e.g. "vedit *.c *.h")

This will let you edit files of any size, but limits you to 2000 keystrokes -
it will then exit after letting you save or abandon your changes.

Alternatively, you can run the trial with an unlimited number of keystrokes,
but cannot save files greater than 2K in size. The command is:

        vedit -d filename

To run VEDIT from any directory, you must add the VEDIT Installation
directory to the PATH command in your AUTOEXEC.BAT file. After modifying your
AUTOEXEC.BAT, you must re-boot for the changes to take effect.

Alternatively, copy just the VEDIT.EXE file to another directory which is
already in the PATH command.


Browsing Files
--------------

VEDIT has a special mode for browsing files; this prevents accidental
alterations. In browse mode you can instantly jump to the beginning or end
of the file, or to a relative position in the middle when using a mouse.

VEDIT lets you browse and perform searches in files up to 2 Gigabytes in
size with the command:

        vedit -d -b filename


Disk Sector Editing
-------------------

The Trial version of VEDIT can open the disk for browsing and searching,
but cannot modify sectors. This prevents you from corrupting your disk while
experimenting with the disk sector editing capabilities.

NOTE:   The disk sector editing does not support the 32-bit FAT in
        Windows 95 Service Pack 2, and in Windows 98.


Other Invocation Options (Troubleshooting)
------------------------------------------

If you have a B/W monitor, e.g. a "Monochrome VGA", you may need the "-M"
option; otherwise the pull-down menus may be blank. Use the command:

        vedit -m filename

VEDIT normally increases the typematic (repeat) rate of the keyboard. This
causes problems (slow exiting, hanging) on some machines. In particular, it
often causes problems with Windows NT and OS/2. Use the "-K" option to have
VEDIT leave the typematic rate unchanged:

        vedit -k filename

If you are using a Microsoft or Logitech mouse, VEDIT will start up faster
(by a few seconds) if you use the "-P" option. (It skips the time consuming
"hardware" mouse reset.) However, "-P" will prevent the Mouse Systems and
possibly other mouse drivers from working properly.

        vedit -p filename

(VEDIT can be configured so that these invocation options aren't needed.)

For a summary of all VEDIT invocation options, give the command:

        vedit /?


To Run the Compiler Support
---------------------------

NOTE:   Most users will find that the compiler support works better in the
        Windows version of VEDIT, even when running DOS based compilers
        and assemblers.

Assuming you chose to install the compiler support files during the
installation, you can try out VEDIT's integrated compiler support. It does
require some additional set up.

You will be able to compile and link the two supplied example programs
ADDER.C and VGA50.ASM; each purposely contains several obvious syntax errors
for you to experiment with.

The Compiler Support is initially set up for Microsoft (Visual) C/C++ and
MASM. If you prefer to use Borland's Turbo C and Turbo Assembler, run the
batch file BORLAND.BAT:

        borland

Print the file COMPILE.TXT which gives detailed instructions on demonstrating
the Compiler Support.

To start up VEDIT and load the Compiler Support, you can use the batch file
"COMPILE.BAT":

        compile adder.c

Alternatively, if you have installed the V-SWAP program described below, you
can start up the Compiler Support while editing by selecting the menu item
{MISC, Load Compiler support}.

Follow the instructions in COMPILE.TXT.

The on-line help topic "COMPILE" describes VEDIT's compiler support in
complete detail.

VEDIT includes modules to support these and other compilers:

Microsoft:   C++, C, Quick C, Quick Basic, Fortran, Cobol, MASM Assembler
Borland:     C++, Turbo C, Turbo Pascal, Turbo Assembler
Avocet:      All Compilers, Assemblers and Cross-compilers
Lahey:       Fortran 77, Personal Fortran 77
Metaware:    High C
Micro Focus: Cobol
Microrim:    RBase Compiler
Nantucket:   Clipper Compiler
Realia:      Cobol
SDS:         C/C++ CrossCode Compiler
Watcom:      C/C++ Compiler
Others:      2500 AD, Acucobol, Microtec, SVS, etc.


The V-SWAP Program
------------------

V-SWAP is a small TSR program with which VEDIT can completely swap itself and
any desired TSRs out of memory in order to run the largest compilers and
debuggers. V-SWAP is normally run from your AUTOEXEC.BAT file, but for this
trial you can run it manually:

        vswap /e:1024

(If your environment is larger than 1024 bytes, increase the "/E:nnn"
parameter.)

Now edit the file ADDER.C:

        vedit adder.c

If desired, you can remove V-SWAP from memory after exiting VEDIT:

        vswap /r

To fully utilize V-SWAP under real DOS or Windows 3.1, it should be run from
within your AUTOEXEC.BAT file. Place the command "VSWAP /E:1024" before other
TSRs such as desktop utilities. All TSRs following the VSWAP command will be
swapped out of memory. (However, the VSWAP command must follow any disk cache
programs.)

When VEDIT shells out to DOS (runs DOS programs), V-SWAP will swap VEDIT and
other TSRs out of memory. This can give you more available memory than you
had before you entered VEDIT!

For a summary of all V-SWAP options, give the command:

        vswap /?


Converting Trial Version to Full Product
----------------------------------------

You can easily convert the trial version to the full product; you do not have
to download anything or re-install it.

1.  Purchase VEDIT from Greenview Data. You can order on-line or call us
    at 1-800-458-3348 or (734) 996-1300. We will also accept Purchase Orders
    from companies in the U.S. and Canada with 100 employees or more; they
    should be faxed to us at (734) 996-1308.

    You can order on-line at:    http://www.vedit.com/order.htm

2.  You will promptly receive a serial-registration number by email as soon
    as we process your order, typically within 2 hours during normal business
    hours.

3.  Start VEDIT and enter the serial-registration number in the trial version
    startup dialog box.

    Or select the menu item {HELP, Register VEDIT} and enter the number here.


Description of Files on Disk
----------------------------

Here is a partial list of the files supplied with VEDIT.

VEDIT.EXE       The main VEDIT executable.

VEDIT.PIF       Files for installing the DOS version of VEDIT under
VEDIT.ICO       Microsoft windows. They are described above.

VSWAP.EXE       A small TSR with which VEDIT can completely swap itself and
                any desired TSRs out of memory in order to run large
                compilers and debuggers. The command "VSWAP /?" displays all
                VSWAP options.

VPHELP.HLP      The on-line help file for VEDIT. You can print any desired
                portions of this file.

WHATSNEW.TXT    A summary of enhancements made to VEDIT in the past several
                years. Primarily oriented towards previous VEDIT users.

HELP.BAT        A very simple Help system that uses the DISPLAY.VDM macro. It
                displays the file HELP.TXT.

PRINT.VDM       Simple "macro" for printing files. It prints the filename
                date and page number on each page and is a nice alternative
                to the DOS "PRINT" command. To print the file "myfile" give
                the DOS command:

                VEDIT -Z -X PRINT myfile

DISPLAY.VDM     Simple macro for displaying files. Uses a window to give
                instructions and is a nice alternative to the DOS "TYPE"
                command. To display the file "myfile" give the DOS command:

                VEDIT -Z -X DISPLAY myfile

                Alternatively, you can create a batch file "D.BAT" containing
                "VEDIT -Z -X DISPLAY %1". Then use the simpler command:

                D myfile

CFUNC.VDM       This macro is a C program outliner that permits viewing and
                navigating a C program via its subroutine declarations. It
                can be run via the {MISC, More macros, Cfunc} function.

COLOR.VDM       This macro is automatically loaded by {USER, Color scheme}
                and {MISC, More macros, Color}. It permits selecting a
                different screen color scheme.

COLORKEY.VDM    Simple macro for changing the text color using a color chart.
                It can be run from {MISC, Load/execute macro}.

DBASE.VDM       This macro sets VEDIT "record size" and "header size"
                according to the currently loaded .DBF file. Also displays
                the table structure in an easy-to-read format with all field
                names, types and sizes identified. It can be run via the
                {MISC, More macros, dBase} function.

DBASEKEY.VDM    This macro sets VEDIT "record size" and "header size"
                according to the currently loaded .DBF file.

SALLBUFF.VDM    This macro is automatically loaded by the {SEARCH, Search
                buffers macro} function. It permits searching all files
                currently being edited.

SRCHINCR.VDM    This macro is automatically loaded by the {SEARCH,
                Incremental search}. It performs incremental searching as
                you enter the search string.

VEDITSAV.VDM    This macro is automatically loaded by VEDIT when the option
                to enable the edit session restore has been selected.

WILDFILE.VDM    This macro is automatically loaded by the {MISC, WILDFILE
                macro} function. It permits performing a search/replace on an
                entire group of files, e.g. all files in a directory. It can
                also be run from DOS with the supplied WILD.BAT file:

                WILD

KEY-MAC.LIB     Library of useful keystroke macros that can be added to VEDIT
                and assigned to a "hot key". It includes duplicating
                characters and lines, moving the cursor by sentence, listing
                lines containing a text string, transposing characters,
                counting words, finding the longest line, and much more.

TUTOR.MNU       The default {Tutorial} menu; it is loaded by the STARTUP.VDM
                macro.

USER.MNU        The default {USER} menu; it is loaded by the STARTUP.VDM
                macro.

ANSI.TBL        This translation table can be loaded into VEDIT to replace
                the default EBCDIC table.

C.SYN           Syntax highlighting definition file for the C language.
CLIPPER.SYN     Syntax highlighting definition file for Clipper.
MBASIC.SYN      Syntax highlighting definition file for Microsoft Basic.
PASCAL.SYN      Syntax highlighting definition file for Pascal.
VEDIT.SYN       Syntax highlighting definition for VEDIT macro language.

BRIEF.KEY       These files are alternate keyboard layouts which emulate
WORDPERF.KEY    Brief, Word Perfect and WordStar. The emulations are
WORDSTAR.KEY    described in the corresponding ".DOC" files. Instructions
                for using the ".KEY" files are given below.

T-xxxx.VDM      The macros used by the {HELP, Tutorial} menu.

DEMOxx.TXT      Text files and instruction files which make up the Tutorial.
                Automatically loaded by the tutorial macros.

EXAMPLE.DB      Example database type file with "fixed-length" records. It
                is used during the Tutorial.

SAMPLE.HTM      Example HTML file for a simple Web page. It is used during
                the Tutorial.

DATABASE.EBC    Example EBCDIC database file with packed, binary and zoned
                fields. It is used during the Tutorial to demonstrate the
                separately sold EBCDIC to ASCII conversion packages.

DATABASE.ASC    Example database file after it is converted to ASCII.
DATABASE.LAY    Example data layout file for DATABASE.EBC for demonstrating
                the conversion packages.



Enjoy VEDIT and be sure to contact us if you have any questions.
----------------------------------------------------------------

Since real people answer the phones and there rarely is any delay to reach
technical support or sales, please call us if you encounter any problems or
have any questions! We also promptly reply to e-mail.

Greenview Data Inc.
PO Box 1586
Ann Arbor, MI 48106


Toll Free:   (800) 458-3348  (U.S. and Canada)
Telephone:   (734) 996-1300
Fax:         (734) 996-1308
E-mail:      sales@vedit.com or support@vedit.com
Web site:    www.vedit.com
