This is the sample implementation of using SGML to format Internet
documents.  It contains the following:

Bibliography
	Robin Cover's "Standard Generalized Markup Language Annotated
	Bibliography and List of Resources".  This is an excellent list of
	literature on SGML, free implementations, commercial software, and
	user's groups.

Makefile
	Makefile to build the Amsterdam SGML Parser.  See the instructions
	below.

README
	This file.

asp [directory]
	The source code for the Amsterdam SGML Parser.  See the instructions
	below for how to build it.

doc [directory]
	The Internet Draft describing the purpose behind this distribution.
	Versions are available in SGML (.sgml), PostScript (.ps), troff -ms
	(.ms), and ASCII with overstrikes and underlines (.ascii).  Read this
	document before trying to figure out the rest of this stuff.

inetdoc1.dtd
	The INETDOC1 document type definition, for describing the format of
	Internet documents with SGML.

inetdoc1.ms.rep
	An ASP replacement file to convert INETDOC1-conforming SGML element
	tags to "troff -ms".

samples [directory]
	Sample document type definitions and entity files from other
	projects.  See the README file in this directory for more info about
	its contents.

Building the ASP
----------------
To build the parser, simply say "make" from the top level directory (the
directory containing this README file).

This will build LLgen, the LL(1) parser generator, and then will build ASP,
the Amsterdam SGML Parser.

To build a parser for a specific DTD, use the "sgml" script, with the name of
the DTD file as an argument.  For example,

  % sgml inetdoc1.dtd

This will generate a program called "name.dtd", where "name" is the name of
the document type.  The above example would create the file "inetdoc1.asp".

Running the ASP
---------------
To simply execute the ASP on a document, run it with no arguments.  For
example:

  % inetdoc1.asp doc/draft-curry-sgmlrfcformat-00.sgml > out

This will produce a correctly marked-up SGML document with all missing markup
inserted, and so on, in the file "out".

To run the ASP with a replacement file, use the "-r" option:

  % inetdoc1.asp -r inetdoc1.ms.rep doc/draft-curry-sgmlrfcformat-00.sgml > out

This will produce a copy of the document with all SGML tags converted to
their replacement values as defined in the replacement file.

Questions and Comments
----------------------
Please direct all questions and comments to:

	David A. Curry
	Purdue University
	Engineering Computer Network
	1285 Electrical Engineering Building
	West Lafayette, IN 47907-1285

	Phone:  (317) 494-3561
	Fax:    (317) 494-6440
	E-Mail: davy@ecn.purdue.edu
