.SH
Installation notes for MS-DOS diskettes
.LP
The installing instructions in the technical documentation
refer to the situation when the sources are delivered
on a tape in Unix tar-format.
.LP
The installation from MS-DOS diskettes is slightly more work.
You have to make sure first that the correct directory structure
is formed on the system, where the parser is to be installed.
.LP
First create a directory `Parser',
with two subdirectories `LLgen' and `Src'.
.LP
Within the directory `Parser/LLgen' the subdirectories
`src', `lib', and `lib/LLgen' must be created.
.LP
The sources for LLgen must be put in the the directory `Parser/LLgen'
and its subdirectories, as they are on the diskette
with volume name LLGENSRC.
The names of all files must be in lower-case, except for the files
in the subdirectory `src' called `llgen.g', `llgen.c', `lpars.c' and `lpars.h'.
These must be spelled as `LLgen.g', `LLgen.c', `Lpars.c' and `Lpars.h'
respectively.
.LP
The sources for the parser, on the diskettes ASPSRC1 and ASPSRC2
must be put in the directory `Parser/Src'.
The file `makefile' must start with an upper-case M: `Makefile'.
.LP
Within this directory `Parser/Src', two subdirectories called `GEN'
and `DOC' must be created.
These directories are used for creating the generator and document-parsers,
respectively.
Once this is done, proceed according to the instructions in the
technical documentation.
.LP
On diskette ASPSRC1, there are several files that can help you
test the ASP.
The file `simple.dtd' contains a very simple DTD, which can be
used to generate the first document-parser.
If the document parser is generated, it can be tested with the
file `simple.doc' as document.
.LP
As a more practicle example there are also six files, concerning
a DTD which formalizes part of the Troff ms-macro package.
The file `article.dtd' contains a DTD for an article.
The file `article.doc' contains a document for the DTD in `article.dtd'.
The file `article.rep' contains a replacement file, which converts
a document to a Troff-ms document.
The file `article.std' contains a replacement file, that
gives the same output as if the `complete' document was generated.
The file `article.mac' contains additional Troff macros used in `article.rep'.
The file `article.ref' contains references in refer format that are
used in `article.doc'.
.LP
The command:
.nf
    `asp article.dtd'
.fi
should create a document parser called `asp_article.dtd'.
.LP
The commands:
.nf
    `asp_article.dtd -r article.std article.doc'
    `asp_article.dtd article.doc'
.fi
Should both generate the same output.
.LP
The command:
.nf
    `asp_article.dtd -r article.rep article.doc >article.troff'
.fi
should create a Troff document on the file article.troff.
.LP
After creating the Troff file `article.troff' from `article.doc', the command
.nf
    refer -n -e -p article.ref article.mac article.troff | pic | tbl | eqn | troff -ms
.fi
will produce the article on the typesetter.
.LP
It is recommended to look at these example files and to try them.
