### htxp-1.0 README file

    (For details see http://www.mcs.anl.gov/home/kwong/htxp1.html)

                                                Man Kam Kwong
                                            kwong@mcs.anl.gov
                            http://www.mcs.anl.gov/home/kwong
                             Mathematics and Computer Science
                                  Argonne National Laboratory

       ---------------------------------------------------------------
       |  I have written a program to help myself in writing HTML    |
       |  documents. I find it very useful; it saves me a lot of     |
       |  time.  I am sharing it, hoping that others will find it    |
       |  useful also.  Certainly, bugs and imperfections exist.     |
       |  Comments and suggestions are more than welcome.            |
       ---------------------------------------------------------------

         ******* "htxp" IS A SPECIAL APPLICATION OF A MORE GENERAL
                 PROGRAM "magicxp", WHICH CAN BE CUSTOMIZED TO
                 PREPROCESS OTHER MODERATELY COMPLEX DOCUMENT FORMATS.

    The program is a filter that generates a regular HTML file from a raw
    source file which is essentially an HTML file with abbreviations and
    macros replacing long strings.  There is built-in shorthand for the
    most common HTML tags, and a user can add abbreviations and macros
    (either in external files or in-line).

    Regular HTML tags can still be used, so that none of the macros are
    mandatory.  You just use as many macros or abbreviations as you
    can remember.  This also allows you to use "htxp" to modify an
    existing HTML file.

    A help utility "hhelp" is also available.

    Here is a sample raw file (file name "pitch"):

      *****************************************************************
      *
      * ]h
      *    .t   My first ;h ;dc
      *    .ab  h  //www.mcs.anl.gov/home/kwong
      * ]H
      *
      * .i   $h/;h.gif
      * .p
      * .h2
      * .ah $h/pitch Click here to see the raw ";h" file
      * .H2
      * .1   Why ;h?
      *
      * .u
      *    . ;;abs can save you time (terms you use very
      *         frequently, and what about those //www.... path names)
      *    . ;h lets you use ;abs for any ;dc preparation,
      *         whether HTML or not
      *    . You can make your own environments with macros
      * .U
      *
      * ]rm
      * For details
      * .ah  $h/htxp1.html  click here;
      * for a homemade help utility
      * .ah  $h/hhelp.html  see hhelp;
      * for comments send email to $em.
      * ]Rm
      *
      ****************************************************************

    The command

        htxp pitch > pitch.html

    expands the file as follows (see the actual result in
    http://www.mcs.anl.gov/home/kwong/pitch.html):

      *****************************************************************
      *
      * <html><head><link  rev="made" href="mailto:kwong@mcs.anl.gov">
      *    <title>My first htxp document</title>
      *    <!-- htxp .ab  h  //www.mcs.anl.gov/home/kwong -->
      * </head><body>
      *
      * <img src="//www.mcs.anl.gov/home/kwong/htxp.gif">
      * <p>
      * <h2>
      * <a href="http://www.mcs.anl.gov/home/kwong/pitch">Click here to see the raw "htxp" file</a>
      * </h2>
      * <h1>Why htxp?</h1>
      *
      * <ul>
      *    <li> Abbreviations can save you time (terms you use very
      *         frequently, and what about those //www.... path names)
      *    <li> htxp lets you use abbreviations for any document preparation,
      *         whether HTML or not
      *    <li> You can make your own environments with macros
      * </ul>
      *
      * <blockquote><i><img src="./yellowball.gif"><img src="./sp10.xbm">
      * <strong>REMARKS:</strong><img src="./sp10.xbm">
      * For details
      * <a href="http://www.mcs.anl.gov/home/kwong/htxp1.html"> click here;</a>
      * for a homemade help utility
      * <a href="http://www.mcs.anl.gov/home/kwong/hhelp.html"> see hhelp;</a>
      * for comments email to <a href="mailto:kwong@mcs.anl.gov">kwong@mcs.anl.gov</a>.
      * </i></blockquote>
      *
      ****************************************************************

    Here are some brief explanations of the "htxp" commands:

      o  Dot commands (".ht", ".t", etc.) are built-in shorthand for common
         HTML tags.  They are like NROFF commands (if you know them), and
         must be the first nonwhite character in a line.

      o  Two abbreviation lists are used to allow for more abbreviations.

         ";h", ";dc", etc. are user-defined abbreviations you make up
         yourself and store in a file called "html.ab1"

         "$em" is from a second similar list stored in "html.ab2"

      o  Additional abbreviations can be also be defined  "dynamically"
         and added to the second list using the command ".ab ...".

      o  "]h", "]H", etc.  are user-defined macros, stored in a file
         "html.ucm".  Here we use them to define a header "environment".
         Similarly, "]rm" and "]Rm" give a remark "environment"
         for writing "REMARKS".

         Such macros can also be added dynamically in the document.

      o  The symbols ";", "$", and "]" for requesting abbreviations
         and macros are changeable.

    (For details see http://www.mcs.anl.gov/home/kwong/htxp1.html)