\format
    This file contains documentation on several macros for use with the
text editor TxEd+.  These macros will make it easier for you to write
hypertext documents with TxEd+.  There are macros for inserting '\\'
commands and testing out your current document.  The big macro is for
creating links. The "link" macro will pop up a requestor which you can use
to fill in and specify the type of link you want (more on this later).

    To use these macros, you should append the startup.txed file in the
Rexx directory on this disk to your personal startup.txed file.  You
will also have to copy over the '.txed' files in the Rexx directory to
wherever your REXX: directory is.  You may want to check to make sure there
are no conflicts with your personal setup (there shouldn't be, but just
in case).


\underline What exactly is there? \underline

    The are three main files.  The first, \ital startup.txed, \ital setups
the environment.  It defines some \bold control-key \bold based macros and
adds some menu items to the "User" menu.

\ital The control-key sequences are: \ital

Control-b	 Turn bolding on/off

Control-i	 Turn italics on/off

Control-u	 Turn underlining on/off

Control-c	 Center text

Control-d	 Indent text

Control-f	 Turn Formatting on

Control-r	 Turn FreeFormatting on

Control-L	 Define a link on current highlighted text


    These macros will insert the appropriate '\\' commands directly into
your document.	For example, to start bolded text you would press
control-b, type your text, and press control-b again to turn bolding off.
That is all that's required.  You won't see any special text styles on the
screen, only the '\\' codes.  However when HT displays it, you will see the
appropriate style.


\underline Defining Links inside of TxEd \underline

    The Control-L macro will define a link.  You would highlight a section
of text either using RightAmiga-B or the mouse (just like you would for a
cut or copy operation).  Then press Control-L or choose "Link Block" from
the User menu.	This will present you with a requestor which you can fill
out. Click the type of link you would like, fill in the string gadget as
needed and close the requestor.  The appropriate command will be inserted
into your document.

    If you would like to get a quick file list, pressing the "File List"
gadget will pop up an Arp File requestor which you can use to pick out a
specific file name.  That file name will be inserted into the string gadget
if you click "OK" on the file requestor.

    In addition, if you would like to verify that a link will work
properly, you can use the "Preview" gadget to test the link.  Clicking the
Preview gadget will cause the link you are defining to be executed.  This
is convienent for making sure things work as expected.


\underline Testing the current document. \underline

    You can then use the "Test File" option to see your document in HT.
This command will save your file, and then instruct HT to load it directly
in.  This works excellently for quickly writing and testing Hypertext
documents.  In addition it saves your work for you, helping to prevent an
accidental loss.


\underline What else is there? \underline

    That about covers it for TxEd.  The macro coverage should be about
100%, but working from these examples, I'd imagine you could trivially add
any new commands you wanted to.  Even adapting this to another editor is
fairly easy.  You may also want to look at the interfaces to the other
editors. Most of the features are fairly standard across each of the
editors, but there are some subtleties (sp?) with each editor.

