Interactive WarpLink Documentation Version 1.00
===============================================

Interactive WarpLink is a front-end user interface for use with
WarpLink. Although WarpLink is not a requirement to use this
program, it's probably valueless to anyone who doesn't own
WarpLink. You really need WARPLINK.EXE -- or whatever you may
have renamed it to -- to use Interactive WarpLink to much effect.

Interactive WarpLink is a heavily modified version of Version 6
of Al Stevens' D-Flat application published in Dr. Dobb's
Journal magazine. It also uses the Overlay() library by Greg
Martin when shelling out to DOS or when linking to minimize
memory impact. Interactive WarpLink was written in Borland C++
version 2.0, ANSI C standard mode.

Most of Interactive WarpLink should be self-explanatory for
those who have used a windowing user interface before. If a
mouse is detected, it will automatically be enabled.

Here is a brief rundown of what you'll see when you start
Interactive WarpLink.

There are four windows visible upon startup. In the leftmost
window you place your object modules to be linked in. '+' signs
at the ends of lines are not necessary, Interactive WarpLink is
smart enough to do most of the housekeeping for you.

The next window is for libraries, and operates the same as the
Object Module window.

The Link Options window is where you set various link options by
move the highlight bar and pressing the spacebar. Some link
options take an additional setting -- required or optional --
which Interactive WarpLink will prompt for. The only two link
options which have optional addtional settings are the CLP5 and
the OX options. Additional settings are retained if the option
is turned off.

The Link Options window also lets you explicitly set the EXE (or
COM) and MAP filename.

The fourth window, Link File Name, is the default link file name
changes are saved to.

There is a fifth window which only comes up after you link from
Interactive WarpLink. It will show any errors or warnings that
occur during a link.

Now for how to use the dropdown menus....

The three lines at the top left corner activated by the mouse or
ALT '-', allow you to move and resize the Interactive WarpLink
environment. You probably won't need to use it.

The File menu, activated by mouse or ALT-F, drops down with 6
different options. They are:

Load, shortcut key F3. This loads and processes a link
file. Object modules, libraries, and link options are
automatically split up to the proper window. You can load
more than one link file at a time. Subsequent link file
loads are appended to pre-existing settings and text.

New. This resets and zeros all the settings, except link options.

Save, shortcut key F2. Automatically saves the text and
settings to the link file specified in the Link File Name
window. If there is no link file specified, same as Save As.

Save As. Prompts for a link file name, then operates as Save.

DOS Shell, shortcut key ALT-D. Shells to DOS. Memory image
is written to disk in a temporary file to conserve memory.
Type EXIT at the DOS prompt to return to Interactive
WarpLink.

Exit, ALT-X. Exits you back to DOS. Not a shell, you leave
the program.

The Edit menu has 6 different options:

Object Files, ALT-1. Places you in the Object Files window.

Libraries, ALT-2. Places you in the Library window.

Options, ALT-3. Places you in the Link Options window.

Link File, ALT-4. Places you in the Link File Name window.

Reformat, F4. Cleans up the object module and library list.
Automatically performed when saving a link file.

Error Log, ALT-5. Places you in the WarpLink Error Log window.

The Link menu only has one option:

Link, F7. Shell to DOS, attempt to link with the current
settings. Note that the temporary files IWTEMP.$$$ and
IWTEMP2.$$$ are created during this process. They can be
safely deleted later.

This process does NOT save to the current Link File Name in
Window 4, but rather to a temporary file. Therefore, it
can be used for testing purposes without disturbing things.

If an error or warning occurred during the link, Interactive
WarpLink will notify you of this and then display the Error
Log window, which is redirected output of all linker messages.

The Project menu has two options:

Load. Load a previously save Project file, replacing all
current settings with the Project file settings.

Save. Save all settings to a Project file.

The Environment menus has two options. Each option has two suboptions.

Defaults. Suboption one allows you to set the default Link
File Extension. Normally this is set to .LNK, but you can
change it and save it via a project file. Suboption two
allows you to give a new name for WARPLINK.EXE in case you
renamed it, or a path in case it isn't along your PATH setting.

Search Paths. This temporarily sets the OBJ and LIB
environment variables when Interactive WarpLink shells out
to link. If you already have set the OBJ and LIB
environment variables in the master environment, they will
be superseded by these settings. If you do not set these
options, the master environment setting is used if it
exists.

You can automatically load a project file on startup by typing the
project name after IW, that is, IW [project_file_name]. A .PRJ
file extension is assumed if none is given.

Two project files have been included to get you started. One is
for Clipper Summer '87 called S87OVL.PRJ, the other is for
Clipper 5.01 called C501OVL. They assume that you will be using
overlays with these languages. These project files contain
several appropriate switch settings and overlayable CLIPPER.LIB
modules. If you experience difficulty or significant slowdown
when using these settings you may wish to remove some or all of
the overlayable CLIPPER.LIB modules.

Remember that other options are available for speeding up link
times or freeing up memory, such as /xp, /xt, /ox, /orp, /ort,
or /em. Use them where appropriate and desired.

This is a version 1.00 program and feedback on its operation is
welcome. Send CompuServe e-mail to Michael Devore [71540,62],
GEnie mail to MDEVORE, or leave a message to me on the
hyperkinetix BBS at 714-935-0832 or in the hyperkinetix forum
section of CompuServe (GO PCVEND, section 9).

Interactive WarpLink is copyright 1991, Michael E. Devore. It
is free for noncommercial distribution (i.e. you can't charge
for it). Michael E. Devore makes no claim as to fitness for a
particular purpose for Interactive WarpLink. Under no
conditions will Michael E. Devore be held liable for damages of
any kind arising out of the use of or inability to use
Interactive WarpLink.