File: osgmlnorm.xml

package info (click to toggle)
opensp 1.5.2-13
  • links: PTS
  • area: main
  • in suites: bookworm, bullseye, buster, sid, stretch
  • size: 8,932 kB
  • ctags: 10,036
  • sloc: cpp: 65,784; ansic: 17,124; sh: 11,503; xml: 2,704; makefile: 926; perl: 561; yacc: 288; sed: 16
file content (253 lines) | stat: -rw-r--r-- 9,926 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
<?xml version='1.0'?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
 "/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd">
<article>
  <articleinfo>
    <title>osgmlnorm</title>
    <author>
      <firstname>James</firstname>
      <surname>Clark</surname>
    </author>
    <author>
      <firstname>Ian</firstname>
      <surname>Castle</surname>
      <affiliation><address><email>ian.castle@openjade.org</email></address></affiliation>
    </author>
    <copyright>
      <year>2002</year>
      <holder>OpenJade Project</holder>
    </copyright>
  </articleinfo>

  <section>
    <title>Reference</title>
    
    <refentry>
      <refentryinfo>
        <title>osgmlnorm</title>
        <date>January 2002</date>
        <productname>OpenJade</productname>
      </refentryinfo>

      <refmeta>
        <refentrytitle>osgmlnorm</refentrytitle>
        <manvolnum>1</manvolnum>
      </refmeta>

      <refnamediv>
        <refname>osgmlnorm</refname>
	<refpurpose>An SGML/XML document normalizer</refpurpose>
      </refnamediv>

      <refsynopsisdiv>
        <cmdsynopsis>
          <command>osgmlnorm</command>
          <arg choice="opt"><option>-CdeghmnrRvx</option></arg>
          <arg choice="opt"><option>-a<replaceable>linktype</replaceable></option></arg>
          <arg choice="opt"><option>-A<replaceable>architecture</replaceable></option></arg>
          <arg choice="opt"><option>-b<replaceable>bctf</replaceable></option></arg>
          <arg choice="opt"><option>-c<replaceable>catalog</replaceable></option></arg>
          <arg choice="opt" rep="repeat"><option>-D<replaceable>directory</replaceable></option></arg>
          <arg choice="opt" rep="repeat"><option>-E<replaceable>max_errors</replaceable></option></arg>
          <arg choice="opt" rep="repeat"><option>-i<replaceable>name</replaceable></option></arg>
          <arg choice="opt" rep="repeat"><option>-f<replaceable>name</replaceable></option></arg>
	  <arg choice="opt" rep="repeat"><option>-w<replaceable>warning</replaceable></option></arg>
          <arg rep="repeat"><replaceable>sysid</replaceable></arg>
    
<!--
   sgmlnorm [ -Cdemnv ] [ -bbctf ] [ -ccatalog ] [ -Ddir ] [ -iname ] [
   -wwarning ] sysid...
-->
        </cmdsynopsis>
      </refsynopsisdiv>
   
      <refsect1>
        <title>Description</title>

   <para><command>osgmlnorm</command> prints on the standard output a normalized document instance
   for the SGML document contained in the concatenation of the entities
   with system identifiers <cmdsynopsis><arg rep="repeat"><replaceable>sysid</replaceable></arg></cmdsynopsis>.</para>
   
   <para>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:</para>
<para>* The output of osgmlnorm does not protect against the recognition of
       short reference delimiters, so any USEMAP declarations must be
       removed from the DTD.</para>
     <para>* The normalized instance will use the reference delimiters, even if
       the original instance did not.</para>
     <para>* 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.</para>
     <para>* Any ESIS information relating to the SGML LINK feature will be
       lost.</para>
       
   <para>The normalized instance will not use any markup minimization features
   except that:</para>
<para>* Any attributes that were not specified in the original instance
       will not be included in the normalized instance. (Current
       attributes will be included.)</para>
     <para>* 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 &lt;DL COMPACT&gt;
       rather than &lt;DL COMPACT="COMPACT"&gt;</para>
       
        <para>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.</para>
   <para>The following options are available:</para>
   
   <variablelist>
     <varlistentry>
       <term><option>-a<replaceable>name</replaceable></option></term>
       <term><option>--activate=<replaceable>name</replaceable></option></term>
       <listitem>
          <para>Make doctype or linktype <replaceable>name</replaceable> active.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>-A<replaceable>architecture</replaceable></option></term>
       <term><option>--architecture=<replaceable>architecture</replaceable></option></term>
       <listitem>
          <para>Parse with respect to architecture <replaceable>architecture</replaceable>.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>-b<replaceable>bctf</replaceable></option></term>
       <term><option>--bctf=<replaceable>bctf</replaceable></option></term>
       <listitem>
          <para>Use the BCTF with name <replaceable>bctf</replaceable> for output.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>-c<replaceable>sysid</replaceable></option></term>
       <term><option>--catalog=<replaceable>sysid</replaceable></option></term>
       <listitem>
          <para>Map public identifiers and entity names to system identifiers
          using the catalog entry file whose system identifier is
          <replaceable>sysid</replaceable>.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-C</option></term>
       <term><option>--catalogs</option></term>
       <listitem>
          <para>This has the same effect as in <command>onsgmls(1)</command>.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>-d</option></term>
       <term><option>--dtd</option></term>
       <listitem>
          <para>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.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-D<replaceable>directory</replaceable></option></term>
       <term><option>--directory=<replaceable>directory</replaceable></option></term>
       <listitem>
          <para>Search <replaceable>directory</replaceable> for files specified in system identifiers.</para>
          <para>This has the same effect as in <command>onsgmls(1)</command>.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-e</option></term>
       <term><option>--open-entities</option></term>
       <listitem>
          <para>Describe open entities in error messages.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>--error-numbers</option></term>
       <listitem>
          <para>Show error numbers in error messages.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>-h</option></term>
       <term><option>--help</option></term>
       <listitem>
          <para>Display a help text and exit.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>-i<replaceable>name</replaceable></option></term>
       <term><option>--include=<replaceable>name</replaceable></option></term>
       <listitem>
          <para>This has the same effect as in <command>onsgmls(1)</command>.</para>
       </listitem>
     </varlistentry>
          
     <varlistentry>
       <term><option>-m</option></term>
       <term><option>--marked-sections</option></term>
       <listitem>
          <para>Output any marked sections that were in the input document
          instance.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-n</option></term>
       <term><option>--comments</option></term>
       <listitem>
          <para>Output any comments that were in the input document instance.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-r</option></term>
       <term><option>--raw</option></term>
       <listitem>
          <para>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.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-R</option></term>
       <term><option>--restricted</option></term>
       <listitem>
          <para>This has the same effect as in <command>onsgmls(1)</command>.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-v</option></term>
       <term><option>--version</option></term>
       <listitem>
          <para>Print the version number.</para>
       </listitem>
     </varlistentry>

     <varlistentry>
       <term><option>-w<replaceable>type</replaceable></option></term>
       <listitem>
          <para>Control warnings and errors according to type. This has the
          same effect as in <command>onsgmls(1)</command>.</para>
       </listitem>
     </varlistentry>
     </variablelist>
   </refsect1>

   <refsect1>
     <title>See Also</title>
     <para><command>onsgmls(1)</command>, <command>ospam(1)</command>,
     <command>ospent(1)</command>, <command>osx(1)</command></para>
   </refsect1>
 </refentry>
</section>
</article>