'\" t
.\" Title: osgmlnorm
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: January 2002
.\" Manual: Reference
.\" Source: OpenJade
.\" Language: English
.\"
.TH "OSGMLNORM" "1" "January 2002" "OpenJade" "Reference"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
osgmlnorm \- An SGML/XML document normalizer
.SH "SYNOPSIS"
.HP \w'\fBosgmlnorm\fR\ 'u
\fBosgmlnorm\fR [\fB\-CdeghmnrRvx\fR] [\fB\-a\fR\fB\fIlinktype\fR\fR] [\fB\-A\fR\fB\fIarchitecture\fR\fR] [\fB\-b\fR\fB\fIbctf\fR\fR] [\fB\-c\fR\fB\fIcatalog\fR\fR] [\fB\-D\fR\fB\fIdirectory\fR\fR...] [\fB\-E\fR\fB\fImax_errors\fR\fR...] [\fB\-i\fR\fB\fIname\fR\fR...] [\fB\-f\fR\fB\fIname\fR\fR...] [\fB\-w\fR\fB\fIwarning\fR\fR...] [\fIsysid\fR...]
.SH "DESCRIPTION"
.PP
\fBosgmlnorm\fR
prints on the standard output a normalized document instance for the SGML document contained in the concatenation of the entities with system identifiers
.HP \w'\ 'u [\fIsysid\fR...]\&.
.PP
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:
.PP
* The output of osgmlnorm does not protect against the recognition of short reference delimiters, so any USEMAP declarations must be removed from the DTD\&.
.PP
* The normalized instance will use the reference delimiters, even if the original instance did not\&.
.PP
* 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\&.
.PP
* Any ESIS information relating to the SGML LINK feature will be lost\&.
.PP
The normalized instance will not use any markup minimization features except that:
.PP
* Any attributes that were not specified in the original instance will not be included in the normalized instance\&. (Current attributes will be included\&.)
.PP
* 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
rather than
.PP
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\&.
.PP
The following options are available:
.PP
\fB\-a\fR\fB\fIname\fR\fR, \fB\-\-activate=\fR\fB\fIname\fR\fR
.RS 4
Make doctype or linktype
\fIname\fR
active\&.
.RE
.PP
\fB\-A\fR\fB\fIarchitecture\fR\fR, \fB\-\-architecture=\fR\fB\fIarchitecture\fR\fR
.RS 4
Parse with respect to architecture
\fIarchitecture\fR\&.
.RE
.PP
\fB\-b\fR\fB\fIbctf\fR\fR, \fB\-\-bctf=\fR\fB\fIbctf\fR\fR
.RS 4
Use the BCTF with name
\fIbctf\fR
for output\&.
.RE
.PP
\fB\-c\fR\fB\fIsysid\fR\fR, \fB\-\-catalog=\fR\fB\fIsysid\fR\fR
.RS 4
Map public identifiers and entity names to system identifiers using the catalog entry file whose system identifier is
\fIsysid\fR\&.
.RE
.PP
\fB\-C\fR, \fB\-\-catalogs\fR
.RS 4
This has the same effect as in
\fBonsgmls(1)\fR\&.
.RE
.PP
\fB\-d\fR, \fB\-\-dtd\fR
.RS 4
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\&.
.RE
.PP
\fB\-D\fR\fB\fIdirectory\fR\fR, \fB\-\-directory=\fR\fB\fIdirectory\fR\fR
.RS 4
Search
\fIdirectory\fR
for files specified in system identifiers\&.
.sp
This has the same effect as in
\fBonsgmls(1)\fR\&.
.RE
.PP
\fB\-e\fR, \fB\-\-open\-entities\fR
.RS 4
Describe open entities in error messages\&.
.RE
.PP
\fB\-\-error\-numbers\fR
.RS 4
Show error numbers in error messages\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Display a help text and exit\&.
.RE
.PP
\fB\-i\fR\fB\fIname\fR\fR, \fB\-\-include=\fR\fB\fIname\fR\fR
.RS 4
This has the same effect as in
\fBonsgmls(1)\fR\&.
.RE
.PP
\fB\-m\fR, \fB\-\-marked\-sections\fR
.RS 4
Output any marked sections that were in the input document instance\&.
.RE
.PP
\fB\-n\fR, \fB\-\-comments\fR
.RS 4
Output any comments that were in the input document instance\&.
.RE
.PP
\fB\-r\fR, \fB\-\-raw\fR
.RS 4
Raw output\&. Don\*(Aqt perform any conversion on RSs and REs when printing the entity\&. The entity would typically have the storage manager attribute records=asis\&.
.RE
.PP
\fB\-R\fR, \fB\-\-restricted\fR
.RS 4
This has the same effect as in
\fBonsgmls(1)\fR\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
Print the version number\&.
.RE
.PP
\fB\-w\fR\fB\fItype\fR\fR
.RS 4
Control warnings and errors according to type\&. This has the same effect as in
\fBonsgmls(1)\fR\&.
.RE
.SH "SEE ALSO"
.PP
\fBonsgmls(1)\fR,
\fBospam(1)\fR,
\fBospent(1)\fR,
\fBosx(1)\fR
.SH "AUTHORS"
.PP
\fBJames Clark\fR
.RS 4
Author.
.RE
.PP
\fBIan Castle\fR <\&ian.castle@openjade.org\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br