diff --git a/docsrc/osgmlnorm.xml b/docsrc/osgmlnorm.xml
index 79f7ad6..85237fc 100644
--- a/docsrc/osgmlnorm.xml
+++ b/docsrc/osgmlnorm.xml
@@ -173,6 +173,15 @@
Show error numbers in error messages.
+
+
+
+
+
+ Show the generic identifiers of open elements in error
+ messages.
+
+
diff --git a/docsrc/osgmlnorm.xml.manpage b/docsrc/osgmlnorm.xml.manpage
new file mode 100644
index 0000000..79f7ad6
--- /dev/null
+++ b/docsrc/osgmlnorm.xml.manpage
@@ -0,0 +1,253 @@
+
+
+
+
+ osgmlnorm
+
+ James
+ Clark
+
+
+ Ian
+ Castle
+ ian.castle@openjade.org
+
+
+ 2002
+ OpenJade Project
+
+
+
+
+ Reference
+
+
+
+ osgmlnorm
+ January 2002
+ OpenJade
+
+
+
+ osgmlnorm
+ 1
+
+
+
+ osgmlnorm
+ An SGML/XML document normalizer
+
+
+
+
+ osgmlnorm
+
+
+
+
+
+
+
+
+
+
+ sysid
+
+
+
+
+
+
+ Description
+
+ osgmlnorm prints on the standard output a normalized document instance
+ for the SGML document contained in the concatenation of the entities
+ with system identifiers sysid.
+
+ When the normalized instance is prefixed with the original SGML
+ declaration and prolog, it will have the same ESIS as the original
+ SGML document, with the following exceptions:
+* The output of osgmlnorm does not protect against the recognition of
+ short reference delimiters, so any USEMAP declarations must be
+ removed from the DTD.
+ * The normalized instance will use the reference delimiters, even if
+ the original instance did not.
+ * If marked sections are included in the output using the -m option,
+ the reference reserved names will be used for the status keywords
+ even if the original instance did not.
+ * Any ESIS information relating to the SGML LINK feature will be
+ lost.
+
+ The normalized instance will not use any markup minimization features
+ except that:
+* Any attributes that were not specified in the original instance
+ will not be included in the normalized instance. (Current
+ attributes will be included.)
+ * If the declared value of an attribute was a name token group, and
+ a value was specified that was the same as the name of the
+ attribute, then the attribute name and value indicator will be
+ omitted. For example, with HTML osgmlnorm would output <DL COMPACT>
+ rather than <DL COMPACT="COMPACT">
+
+ Part of an SGML System Conforming to International Standard ISO 8879 -- Standard Generalized Markup Language. An SGML Extended Facilities system conforming to Annex A of International Standard ISO/IEC 10744 -- Hypermedia/Time-based Structuring Language.
+ The following options are available:
+
+
+
+
+
+
+ Make doctype or linktype name active.
+
+
+
+
+
+
+
+ Parse with respect to architecture architecture.
+
+
+
+
+
+
+
+ Use the BCTF with name bctf for output.
+
+
+
+
+
+
+
+ Map public identifiers and entity names to system identifiers
+ using the catalog entry file whose system identifier is
+ sysid.
+
+
+
+
+
+
+
+ This has the same effect as in onsgmls(1).
+
+
+
+
+
+
+
+ Output a document type declaration with the same external
+ identifier as the input document, and with no internal
+ declaration subset. No check is performed that the document
+ instance is valid with respect to this DTD.
+
+
+
+
+
+
+
+ Search directory for files specified in system identifiers.
+ This has the same effect as in onsgmls(1).
+
+
+
+
+
+
+
+ Describe open entities in error messages.
+
+
+
+
+
+
+ Show error numbers in error messages.
+
+
+
+
+
+
+
+ Display a help text and exit.
+
+
+
+
+
+
+
+ This has the same effect as in onsgmls(1).
+
+
+
+
+
+
+
+ Output any marked sections that were in the input document
+ instance.
+
+
+
+
+
+
+
+ Output any comments that were in the input document instance.
+
+
+
+
+
+
+
+ Raw output. Don't perform any conversion on RSs and REs when
+ printing the entity. The entity would typically have the
+ storage manager attribute records=asis.
+
+
+
+
+
+
+
+ This has the same effect as in onsgmls(1).
+
+
+
+
+
+
+
+ Print the version number.
+
+
+
+
+
+
+ Control warnings and errors according to type. This has the
+ same effect as in onsgmls(1).
+
+
+
+
+
+
+ See Also
+ onsgmls(1), ospam(1),
+ ospent(1), osx(1)
+
+
+
+
diff --git a/docsrc/ospam.xml b/docsrc/ospam.xml
index 5217f2e..93c2098 100644
--- a/docsrc/ospam.xml
+++ b/docsrc/ospam.xml
@@ -151,6 +151,16 @@
of stderr.
+
+
+
+
+
+ Show the generic identifiers of open elements in error
+ messages.
+
+
+
diff --git a/docsrc/ospam.xml.manpage b/docsrc/ospam.xml.manpage
new file mode 100644
index 0000000..5217f2e
--- /dev/null
+++ b/docsrc/ospam.xml.manpage
@@ -0,0 +1,362 @@
+
+
+
+
+ ospam
+
+ James
+ Clark
+
+
+ Ian
+ Castle
+ ian.castle@openjade.org
+
+
+
+ 2002
+ OpenJade Project
+
+
+
+
+
+ Reference
+
+
+
+ ospam
+ November 2002
+ OpenJade
+
+
+
+ ospam
+ 1
+
+
+
+ ospam
+ An SGML/XML markup stream editor
+
+
+
+
+ ospam
+
+
+
+
+
+
+
+
+
+
+ sysid
+
+
+
+
+
+ Description
+
+ ospam (OpenSP Add Markup) is an SGML markup stream editor implemented using
+ the OpenSP parser. ospam parses the SGML document contained in sysid and
+ copies to the standard output the portion of the document entity
+ containing the document instance, adding or changing markup as
+ specified by the options. The option can be used to include the
+ SGML declaration and prolog in the output. The option can be used
+ to output other entities. The option can be used to expand entity
+ references.
+
+ Part of an SGML System Conforming to International Standard ISO 8879 -- Standard Generalized Markup Language. An SGML Extended Facilities system conforming to Annex A of Internation Standard ISO/IEC 10744 -- Hypermedia/Time-based Structuring Language.
+
+ The following options are available:
+
+
+
+
+
+
+ Make doctype or linktype name active.
+
+
+
+
+
+
+
+ Parse with respect to architecture architecture.
+
+
+
+
+
+
+
+ Use bctf bctf for output.
+
+
+
+
+
+
+
+ Use the catalog entry file sysid.
+
+
+
+
+
+
+
+ This has the same effect as in onsgmls(1).
+
+
+
+
+
+
+
+ Search directory for files specified in system identifiers.
+ This has the same effect as in onsgmls(1).
+
+
+
+
+
+
+ Describe open entities in error messages.
+
+
+
+
+
+
+
+ Exit after max_errors errors are encountered.
+
+
+
+
+
+
+ Redirect errors to file.
+ This is useful mainly with shells that do not support redirection
+ of stderr.
+
+
+
+
+
+
+ Hoist omitted tags out from the start of internal entities. If
+ the text at the beginning of an internal entity causes a tag to
+ be implied, the tag will usually be treated as being in that
+ internal entity; this option will instead cause it to be
+ treated as being in the entity that referenced the internal
+ entity. This option makes a difference in conjunction with
+ or .
+
+
+
+
+
+
+ Display a help text and exit.
+
+
+
+
+
+
+
+ This has the same effect as in onsgmls(1).
+
+
+
+
+
+
+
+ Prefer lower-case. Added names that were subject to upper-case
+ substitution will be converted to lower-case.
+
+
+
+
+
+
+
+ Change the markup in the output according to the value of
+ markup_option as follows:
+
+
+ Add tags that were omitted using omitted tag
+ minimization. End tags that were omitted because the
+ element has a declared content of EMPTY or an explicit
+ content reference will not be added.
+
+
+ Replace short references by named entity references.
+
+
+ Change null end-tags into unminimized end-tags, and
+ change net-enabling start-tags into unminimized
+ start-tags.
+
+
+ Change empty tags into unminimized tags.
+
+
+ Change unclosed tags into unminimized tags.
+
+
+ Add omitted attribute names and vis.
+
+
+ Add literal delimiters omitted from attribute values.
+
+
+ Add omitted attribute specifications.
+
+
+ Add omitted attribute specifications for current
+ attributes. This option is implied by the attspec option.
+
+
+ Equivalent to combination of net, emptytag, unclosed,
+ attname, attvalue and attspec options.
+
+
+ Add omitted rank suffixes.
+
+
+ Put reserved names in upper-case.
+
+
+ Remove marked section declarations whose effective status
+ is IGNORE, and replace each marked section declaration
+ whose effective status is INCLUDE by its marked section.
+ In the document instance, empty comments will be added
+ before or after the marked section declaration to ensure
+ that ignored record ends remain ignored.
+
+ Multiple -m options are allowed.
+
+
+
+
+
+
+
+ Show error numbers in error messages.
+
+
+
+
+
+
+
+ Output the general entity name instead of the document entity.
+ The output will correspond to the first time that the entity is
+ referenced in content.
+
+
+
+
+
+
+
+ Output the part of the document entity containing the SGML
+ declaration (if it was explicitly present in the document
+ entity) and the prolog before anything else. If this option is
+ specified two or more times, then all entity references
+ occurring between declarations in the prolog will be expanded;
+ this includes the implicit reference to the entity containing
+ the external subset of the DTD, if there is one. Note that the
+ SGML declaration will not be included if it was specified by an
+ SGMLDECL entry in a catalog.
+
+
+
+
+
+
+
+ Don't perform any conversion on RSs and REs when outputting the
+ entity. The entity would typically have the storage manager
+ attribute records=asis.
+
+
+
+
+
+
+
+ This as the same effect as in onsgmls(1)
+
+
+
+
+
+
+
+ Print the version number.
+
+
+
+
+
+
+
+ Control warnings and errors according to type. This has the
+ same effect as in onsgmls(1).
+
+
+
+
+
+
+
+ Expand references to entities that are changed. If this option
+ is specified two or more times, then all references to entities
+ that contain tags will be expanded.
+
+
+
+
+
+
+ Bugs
+
+ Omitted tags are added at the point where they are implied by the SGML
+ parser (except as modified by the option); this is often not quite
+ where they are wanted.
+
+ The case of general delimiters is not preserved.
+
+ Incorrect results may be produced if a variant concrete syntax is used
+ which is such that there are delimiters in markup to be added that
+ have a prefix that is a proper suffix of some other delimiter.
+
+ If an entity reference in a default value uses the default entity and
+ an entity with that name is subsequently defined and that default
+ value is added to the document instance, then the resulting document
+ may not be equivalent to the original document. ospam will give a
+ warning when the first two conditions are met.
+
+
+
+ See Also
+ onsgmls(1), ospent(1),
+ onsgmlnorm(1), osx(1)
+
+
+
+