147 lines
4.3 KiB
HTML
147 lines
4.3 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>OSGMLNORM</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
<H1>OSGMLNORM</H1>
|
|
<H4>
|
|
An SGML System Conforming to International Standard ISO 8879 --
|
|
Standard Generalized Markup Language
|
|
</H4>
|
|
<H4>
|
|
An SGML Extended Facilities system conforming to
|
|
Annex A of International Standard ISO/IEC 10744 --
|
|
Hypermedia/Time-based Structuring Language
|
|
</H4>
|
|
<H2>SYNOPSIS</H2>
|
|
<P>
|
|
<CODE>osgmlnorm</CODE> [ <CODE>option...</CODE> ] <CODE><VAR>sysid...</VAR></CODE>
|
|
|
|
<H2>DESCRIPTION</H2>
|
|
<P>
|
|
Osgmlnorm prints on the standard output a <I>normalized</I> document instance
|
|
for the SGML document contained in the concatenation of the entities
|
|
with <A HREF="sysid.htm">system identifiers</A>
|
|
<CODE><VAR>sysid...</VAR></CODE>.
|
|
<P>
|
|
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:
|
|
<UL>
|
|
<LI>
|
|
The output of osgmlnorm does not protect against the recognition of
|
|
short reference delimiters, so any <SAMP>USEMAP</SAMP> declarations
|
|
must be removed from the DTD.
|
|
<LI>
|
|
The normalized instance will use the reference delimiters, even if the
|
|
original instance did not.
|
|
<LI>
|
|
If marked sections are included in the output using the
|
|
<CODE>-m</CODE> option, the reference reserved names will be used for
|
|
the status keywords even if the original instance did not.
|
|
<LI>
|
|
Any ESIS information relating to the SGML LINK feature will be lost.
|
|
</UL>
|
|
<P>
|
|
The normalized instance will not use any markup minimization features
|
|
except that:
|
|
<UL>
|
|
<LI>
|
|
Any attributes that were not specified in the original instance
|
|
will not be included in the normalized instance.
|
|
(Current attributes will be included.)
|
|
<LI>
|
|
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 <CODE><DL COMPACT></CODE>
|
|
rather than <CODE><DL COMPACT="COMPACT"></CODE>
|
|
</UL>
|
|
<H2>OPTIONS</H2>
|
|
<P>
|
|
The following options are available:
|
|
<DL>
|
|
<DT>
|
|
<CODE>-b<VAR>name</VAR></CODE>,
|
|
<CODE>--bctf=<VAR>name</VAR></CODE>
|
|
<DD>
|
|
Use the <A HREF="sysid.htm#bctf">BCTF</A> <VAR>name</VAR> for output.
|
|
<DT>
|
|
<CODE>-c<VAR>sysid</VAR></CODE>,
|
|
<CODE>--catalog=<VAR>sysid</VAR></CODE>
|
|
<DD>
|
|
Map public identifiers and entity names to system identifiers
|
|
using the catalog entry file whose system identifier is <VAR>sysid</VAR>.
|
|
This has the same effect as in <A HREF="nsgmls.htm#optc">onsgmls</A>.
|
|
<DT>
|
|
<CODE>-C</CODE>,
|
|
<CODE>--catalogs</CODE>
|
|
<DD>
|
|
This has the same effect as in <A HREF="nsgmls.htm#optC">onsgmls</A>.
|
|
<DT>
|
|
<CODE>-d</CODE>,
|
|
<CODE>--dtd</CODE>
|
|
<DD>
|
|
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.
|
|
<DT>
|
|
<CODE>-D<VAR>directory</VAR></CODE>,
|
|
<CODE>--directory=<VAR>directory</VAR></CODE>
|
|
<DD>
|
|
Search
|
|
<CODE><VAR>directory</VAR></CODE>
|
|
for files specified in system identifiers.
|
|
This has the same effect as in <A HREF="nsgmls.htm#optD">onsgmls</A>.
|
|
<DT>
|
|
<CODE>-e</CODE>,
|
|
<CODE>--open-entities</CODE>
|
|
<DD>
|
|
Describe open entities in error messages.
|
|
<DT>
|
|
<CODE>-i<VAR>name</VAR></CODE>,
|
|
<CODE>--include=<VAR>name</VAR></CODE>
|
|
<DD>
|
|
This has the same effect as in <A HREF="nsgmls.htm#opti">onsgmls</A>.
|
|
<DT>
|
|
<CODE>-m</CODE>,
|
|
<CODE>--marked-sections</CODE>
|
|
<DD>
|
|
Output any marked sections that were in the input document instance.
|
|
<DT>
|
|
<CODE>-n</CODE>,
|
|
<CODE>--comments</CODE>
|
|
<DD>
|
|
Output any comments that were in the input document instance.
|
|
<DT>
|
|
<CODE>-r</CODE>,
|
|
<CODE>--raw</CODE>
|
|
<DD>
|
|
Raw output.
|
|
Don't perform any conversion on RSs and REs when printing the entity.
|
|
The entity would typically have the storage manager attribute
|
|
<SAMP>records=asis</SAMP>.
|
|
<DT>
|
|
<CODE>-R</CODE>,
|
|
<CODE>--restricted</CODE>
|
|
<DD>
|
|
This has the same effect as in <A HREF="nsgmls.htm#optR">onsgmls</A>.
|
|
<DT>
|
|
<CODE>-v</CODE>,
|
|
<CODE>--version</CODE>
|
|
<DD>
|
|
Print the version number.
|
|
<DT>
|
|
<CODE>-w<VAR>type</VAR></CODE>,
|
|
<CODE>--warning=<VAR>type</VAR></CODE>
|
|
<DD>
|
|
Control warnings and errors according to
|
|
<CODE><VAR>type</VAR></CODE>.
|
|
This has the same effect as in <A HREF="nsgmls.htm#optw">onsgmls</A>.
|
|
</DL>
|
|
</BODY>
|
|
</HTML>
|