HTML->WP51 -- Version 1.01 -- December 28, 1995

HyperText Markup Language (HTML) *to*
WordPerfect 5.1 (WP51) Translator

Program and documentation:
Copyright (c) 1995 by E. Daniel Bors Jr.
All Rights Reserved.

WordPerfect is a registered trademark of WordPerfect Corporation.


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

For those of us laggards who are still using a text browser (such
as Lynx) to navigate the World Wide Web, and WordPerfect 5.1 for word
processing, it is frustrating to download a file written in Hyper-
Text Markup Language, retrieve it into WordPerfect, and find that
the result is almost unintelligible.

HTML->WP51 is intended to solve that problem by simply and quickly
converting an HTML file into a standard WP51 file that is suitable
for reading, editing, spell-checking, printing, and so forth.


-------------------------------
HTML->WP51 Version 1.0 Features
-------------------------------

Selected HTML tags are processed by Version 1.0 as follows:

<body>...</body>              Removes "head" and "tail"
<p>                           Starts a new paragraph (2 HRt's)
<br>                          Forces a line break (1 HRt)
<h#>...</h#>                  Makes ALL headers (#1-6) bold
<ol>...<li>...</ol>           Numbers each list item
<ul>...<li>...</ul>           Indents and adds an asterisk
<dt>                          Starts a new paragraph (2 HRt's)
<dd>                          Starts a new paragraph (2 HRt's)
<pre>...</pre>                Displays pre-formatted text
&keyword;                     Displays the appropriate character

All other tags, as well as extraneous hard returns, tabs and spaces,
are stripped from the text.  HTML->WP51 Version 1.0 works well with most
textual HTML files; however, further refinements are needed and coming.

Also, whether the HTWP51V1.WPM macro is useable/convertible for earlier
or later versions of WordPerfect has not been determined at this time.


------------------------------------
Coming Soon:  HTML->WP51 Version 2.0
------------------------------------

HTWP51V2.WPM is planned for release during the 1st quarter of 1996.
REGISTERED USERS OF "V1" WILL RECEIVE THE NEW "V2" ABSOLUTELY FREE!!

(See below for Registration information.)

Version 2.0 will features an all-new programming strategy that will make
the macro more efficient and, consequently, perceptibly faster, especially
when processing long files.

The following additional HTML tags will be processed as follows:

<listing>...</listing>        Displays pre-formatted text
<xmp>...<xmp>                 Displays pre-formatted text
<blockquote>...</blockquote>  Displays L/R indented text
<plaintext>                   Displays pre-formatted text to end
<hr>                          Draws a horizontal rule
<em>...</em>, etc.            Displays "logical styles"
<b>...</b>, etc.              Displays "physical styles"
<menu>...</menu>              Displays a menu
<dir>...</dir>                Displays a directory list
<address>...</address>        Displays an address

Also the user may select any or all of the following options:

<title>...</title>            Displays document title
<base href="URL">             Displays "base URL"
<h#>...<h#>                   Displays header levels [H#]
<link rev= ... >              Displays "links"
<a xxxx="yyyy">...</a>        Displays hyperlinks & anchors
<img src= ... >               Shows the location of an embedded
                              image and/or displays alternate text

Although not "officially" recognized in HTML, Version 2.0 will let
the user optionally retain tabs and spaces following a Hard Return,
to preserve the author's original format.

And finally, Version 2.0 will include "error compensation" to correct
some of the most common mistakes made by HTML authors.

IMPORTANT NOTE:  HTML->WP51 Version 2.0 will NOT be posted until
Version 3.0 is nearing completion.  The only way to get Version 2.0 
as soon as it is released is to REGISTER Version 1.0 NOW.

--------------------------------------------------
Installation & Operation of HTML->WP51 Version 1.0  
--------------------------------------------------

1.   Macro Directory

     Typically, WordPerfect 5.1 macros are located in a directory
     called C:\WP51\MACROS.  While WordPerfect is running, press
     "Shift-F1" then select "6" and look at "2" (Keyboard/Macro
     Files) to determine where your macros are located.

     Then, at the DOS prompt, copy (or move) HTWP51V1.WPM to your
     WordPerfect macro directory.

2.   Macro Naming

     To launch a WP51 macro with a single keystroke, it must
     have a filename in the form of "Alt<char>.WPM" where <char>
     is a letter from A to Z.  To launch such a macro just hold
     down the "Alt" key and press the letter.

     The alternative is to give the macro a "standard" filename
     with ".WPM" as the extension.  To launch a macro with this
     type of filename, press "Alt-F10" and type the macro filename
     when prompted.

     IF you wish to do so, at the DOS prompt use the "ren" command
     to rename HTWP51V1.WPM, being careful NOT to use a filename
     (especially an "Alt<char>.WPM" filename) that already exists.

3.   (Re)start WordPerfect.

4.   Launch HTML->WP51 as described in #2 above.
     
     If the display screen is not really empty, you will get an
     error message.  Hit "Cancel" to clear the message and then
     "F7-N-N" to clear the display.  Then relaunch HTML->WP51.
     
5.   When prompted, type the HTML filename and extension and hit
     "Enter".  If the HTML file is in your Default Directory, it
     is not necessary to enter the Path.  Press "F5" to see your
     current Default Directory.

     If the file cannot be found, you will get an error message.
     Hit "Cancel," exit the document, relaunch HTML->WP51, and
     try again.

6.   When prompted, press "Y" or "Enter" to leave the display OFF;
     press "N" or any other key to turn the display ON.  It is
     interesting to watch HTML->WP51 at work, but the macro runs
     faster with the display off.  You'll hear various beeps as
     HTML->WP51 does its job, and with the display off you'll see
     various status prompts.

7.   When HTML->WP51 finishes, the converted file will be displayed
     from its beginning.  You may wish to proofread it on screen and
     make various minor adjustments before printing or saving it in
     the normal way.
                              
--------------------------------------
Registration Of HTML->WP51 Version 1.0
--------------------------------------

This program is copyrighted, user-supported shareware, and is NOT in
the public domain.  However, please feel free to make modifications
of it for your own personal use.  Also, you may make complete and
unmodified copies of * VERSION 1.0 ONLY * including this documentation,
with the copyright notices intact for distribution to others.

If, after evaluating HTML->WP51 for a fourteen day trial period, you
find that it meets your needs, please send $10.00 (U.S. funds), your 
postal address, and your e-mail address to:

                    E. Daniel Bors Jr.
                    25 Morning Glory
                    Irvine, CA 92715 USA

REMEMBER:  REGISTERED USERS OF HTML->WP51 VERSION 1.0 WILL RECEIVE
HTML->WP51 VERSION 2.0 * FREE * (VIA E-MAIL) AS SOON AS IT IS RELEASED.

(If you would prefer to receive Version 2.0 on a 3-1/2" disk via snail-
mail, please increase your registration fee to $15.00 U.S. to cover the
disk, copying, shipping and handling.)

If you are unable to pay the registration fee, at least please send me
e-mail at bors@netcom.com and tell me what you think of HTML->WP51. OK?
                              
----------
The Future
----------

As mentioned above, HTML->WP51 Version 1.0 produces useful results
with most HTML files; and  HTML->WP51 Version 2.0 will do an even
better job.  Your suggestions for other refinements and capabilities,
as well as identification of bugs would be appreciated.
