1OSGMLNORM(1)                       Reference                      OSGMLNORM(1)
2
3
4

NAME

6       osgmlnorm - An SGML/XML document normalizer
7

SYNOPSIS

9       osgmlnorm [-CdeghmnrRvx] [-alinktype] [-Aarchitecture] [-bbctf]
10                 [-ccatalog] [-Ddirectory...] [-Emax_errors...] [-iname...]
11                 [-fname...] [-wwarning...] [sysid...]
12

DESCRIPTION

14       osgmlnorm prints on the standard output a normalized document instance
15       for the SGML document contained in the concatenation of the entities
16       with system identifiers
17
18
19
20       When the normalized instance is prefixed with the original SGML
21       declaration and prolog, it will have the same ESIS as the original SGML
22       document, with the following exceptions:
23
24       * The output of osgmlnorm does not protect against the recognition of
25       short reference delimiters, so any USEMAP declarations must be removed
26       from the DTD.
27
28       * The normalized instance will use the reference delimiters, even if
29       the original instance did not.
30
31       * If marked sections are included in the output using the -m option,
32       the reference reserved names will be used for the status keywords even
33       if the original instance did not.
34
35       * Any ESIS information relating to the SGML LINK feature will be lost.
36
37       The normalized instance will not use any markup minimization features
38       except that:
39
40       * Any attributes that were not specified in the original instance will
41       not be included in the normalized instance. (Current attributes will be
42       included.)
43
44       * If the declared value of an attribute was a name token group, and a
45       value was specified that was the same as the name of the attribute,
46       then the attribute name and value indicator will be omitted. For
47       example, with HTML osgmlnorm would output <DL COMPACT> rather than <DL
48       COMPACT="COMPACT">
49
50       Part of an SGML System Conforming to International Standard ISO 8879 --
51       Standard Generalized Markup Language. An SGML Extended Facilities
52       system conforming to Annex A of International Standard ISO/IEC 10744 --
53       Hypermedia/Time-based Structuring Language.
54
55       The following options are available:
56
57       -aname, --activate=name
58           Make doctype or linktype name active.
59
60       -Aarchitecture, --architecture=architecture
61           Parse with respect to architecture architecture.
62
63       -bbctf, --bctf=bctf
64           Use the BCTF with name bctf for output.
65
66       -csysid, --catalog=sysid
67           Map public identifiers and entity names to system identifiers using
68           the catalog entry file whose system identifier is sysid.
69
70       -C, --catalogs
71           This has the same effect as in onsgmls(1).
72
73       -d, --dtd
74           Output a document type declaration with the same external
75           identifier as the input document, and with no internal declaration
76           subset. No check is performed that the document instance is valid
77           with respect to this DTD.
78
79       -Ddirectory, --directory=directory
80           Search directory for files specified in system identifiers.
81
82           This has the same effect as in onsgmls(1).
83
84       -e, --open-entities
85           Describe open entities in error messages.
86
87       --error-numbers
88           Show error numbers in error messages.
89
90       -g, --open-elements
91           Show the generic identifiers of open elements in error messages.
92
93       -h, --help
94           Display a help text and exit.
95
96       -iname, --include=name
97           This has the same effect as in onsgmls(1).
98
99       -m, --marked-sections
100           Output any marked sections that were in the input document
101           instance.
102
103       -n, --comments
104           Output any comments that were in the input document instance.
105
106       -r, --raw
107           Raw output. Don't perform any conversion on RSs and REs when
108           printing the entity. The entity would typically have the storage
109           manager attribute records=asis.
110
111       -R, --restricted
112           This has the same effect as in onsgmls(1).
113
114       -v, --version
115           Print the version number.
116
117       -wtype
118           Control warnings and errors according to type. This has the same
119           effect as in onsgmls(1).
120

SEE ALSO

122       onsgmls(1), ospam(1), ospent(1), osx(1)
123

AUTHORS

125       James Clark
126           Author.
127
128       Ian Castle <ian.castle@openjade.org>
129           Author.
130

132OpenJade                         January 2002                     OSGMLNORM(1)
Impressum