\format
    This file contains information on the macros for use with the text editor
\BOLD DME \BOLD (by Matthew Dillon).  They essentially make DME an HT friendly
editor (read it will be much easier to create HT documents).  This file
assumes that you are somewhat familiar with DME and how it works.  If you
are not familiar with DME, you may wish to use the setup that is on this
disk (as DME is the default editor on disk).

\freeformat
    Here's what there is:

 \ITALIC setup.edrc \ITALIC : This is the main file and contains the
	      keymappings/macros that make the other macros useable.
	      It sets up a couple of macros to handle text style changes
	      and also to do links (but you need the Arexx macros for them
	      to be useful).  It will also add a menu to your titlebar for
	      some easy access to the same functions.

 \ITALIC ht.dme \ITALIC     : This (short) ARexx/DME macro will allow you to quickly test
	      out any file you are currently working on.  It will save your
	      current file, then get HT running (if it isn't), and then
	      instruct HT to load the current file.

 \ITALIC link.dme \ITALIC   : This rather complicated macro will open a window with gadgets
	      for you to fill in and specify the kind of link you would
	      like at the current spot in the text.  It makes specifying
	      links *quite* a bit easier.  You can also preview your link
	      before inserting it.


\center
\bold Installing the DME macros\bold

\format
    To make use of these macro packages, you have to do two things.  First
copy the '.dme' files in the Rexx directory on this disk to your REXX:
directory.  You will also want to copy the S:.edrc file to where you put
your own .edrc file.  If you already have a specific DME setup, you may
wish to edit the .edrc file to make it part of your setup.  Then simply
fire up \BOLD DME \BOLD and source the \ITALIC setup.edrc \ITALIC file. You
will then have an extra menu and several keymaps added to your \BOLD DME
\BOLD enviroment. The menu items simply duplicate what the keymaps do.


\freeformat
NOTE:  When you start the ARexx macros for linking or testing the current
       document, your title bar in DME will flash a lot with various
       messages.  Try to ignore this as it is simply an artifact of the
       REXX interface to DME, everything should proceed normally.

NOTE 2 : The first time you run each of these macros, there will tend to
	 be a fair amount of disk activity.  This is because several of the
	 macros require certain rexx libraries to be present.  Loading them
	 does require some time, but does only happen once.


\center
\underline So how do i use the macros once I've set them up? \underline

\format
    I have setup macros to insert bolding, italicizing, and underling
codes.	These save you the hassle of typing in \\BOLD all the time.  These
macros are all \UNDERLINE Alt-key\UNDERLINE  based.  To make text italic,
simply press \BOLD Alt-i \BOLD	(for italic).  Similarly for \BOLD bolded
\bold text you press \BOLD Alt-b.\BOLD	 To get underlined text you would
press \BOLD Alt-u. \BOLD   These functions are also available via the
'HyperText' menu at the top of the screen.

    There is also a macro to let you test out your current file.  The \BOLD
test \BOLD feature will save your current file to disk, and tell HT to load
that file.  This is very convienent for quickly testing out HT-based
documents as you are writing them.  All you have to do is press \BOLD Alt-t
\BOLD (for "test") or choose "Test Current Document" from the Hypertext
menu.  Doing that, causes HT to load and display your file.  This will let
you see if everything is working properly with your document.


\center
\bold The "Link" Macro\bold

    The final macro is probably the most useful.  It allows you to easily
specify link information.  All you are required to do is simply define the
starting and ending positions of the link, and click your way through a
small requestor.  This macro requires that you have RexxArpLib.library and
screenshare.library in your libs: directory (in addition to arp.library
which should already be there).

    To start defining a link you press Alt-s (for start), then type your
text as you normally would.  Unfortunately the text will not be in inverse
video because DME does not allow this.	When you have finished typing the
text you wish to link, simply press Alt-l (for link).  This will execute
an Arexx macro which pops up a requestor to be filled in.  When you close
the requestor, the appropriate link information is then inserted directly
into your document and you can keep typing.

    The requestor contains gadgets for specifying the type of link, and a
string gadget (field) for the specific information.  If you forget a
file name, you can also get a file requestor by clicking on the "File List"
gadget.  This will open up an Arp file requestor from which you can select
any file.  The file name you select (if any) will be inserted into the link
requestor as needed.  In addition, you can preview your link by clicking
the "Preview" gadget.  This will simulate what would happen if a user were
to follow what you have currently defined as a link.   This is useful to
verify that a link will work as you expect.


    If after the requestor has popped up, you decide that you don't want
to do this link, simply click the close gadget or if the string gadget is
empty, simply hit return in it and it will go away.  That about covers it
for the linking macro.


    That pretty much covers the DME macros.  You should now be able to get
started with DME and HT.  This is a good combo, and is what I used to
create all of the HT documentation.

