README on how to build a rearranged THE-documentation
Franz-Josef Wirtz, mailto:nospam-contact@gut-wirtz.de, 15.August 1999

With these files you can build a rearranged set of HTML-documents
from the source distribution of THE. The rearrangement is basically to
have a booklike organisation of the docs, with only chapter links on
the starting page. The chapter pages are prepended with an index, if
possible, for easy access to the points of interest.

You will need some standard unix tools like echo, ln, rm, sed, grep, cat,
head.

1) Copy the files in the doc-subdirectory into the doc-subdirectory of
your source distribution.

2) Copy the man2html.rex to the source directory

3) Change to your building directory.

4) Copy html.mak to this directory.

5) Within html.mak, adopt the srcdir, docdir and man2html-variable
to your local situation.

6) Build manext or manext.exe with the standard makefile
6a) I suppose, you have already built and installed THE itself. If
not, do it now, you will need it too.

7) Run "make -f html.mak" to build the rearranged docs.

8) Open index.htm in your favorite browser.

BTW: just note, that the htm-files within this distribution are up to
date in respect to version 2.8.

That's it
enjoy
