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
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
|
<?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>ospam</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>ospam</title>
<date>November 2002</date>
<productname>OpenJade</productname>
</refentryinfo>
<refmeta>
<refentrytitle>ospam</refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>
<refnamediv>
<refname>ospam</refname>
<refpurpose>An SGML/XML markup stream editor</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>ospam</command>
<arg choice="opt"><option>-CeghilprRvx</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_file</replaceable></option></arg>
<arg choice="opt"><option>-D<replaceable>directory</replaceable></option></arg>
<arg choice="opt"><option>-f<replaceable>file</replaceable></option></arg>
<arg choice="opt"><option>-m<replaceable>markup_option</replaceable></option></arg>
<arg choice="opt"><option>-o<replaceable>entity_name</replaceable></option></arg>
<arg choice="opt"><option>-w<replaceable>warning_type</replaceable></option></arg>
<arg rep="repeat"><replaceable>sysid</replaceable></arg>
<!--
spam [ -Cehilprvx ] [ -ccatalog_file ] [ -Ddirectory ] [ -ffile ] [
-mmarkup_option ] [ -oentity_name ] [ -wwarning_type ] sysid...
-->
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para><command>ospam</command> (OpenSP Add Markup) is an SGML markup stream editor implemented using
the OpenSP parser. <command>ospam</command> parses the SGML document contained in <replaceable>sysid</replaceable> and
copies to the standard output the portion of the document entity
containing the document instance, adding or changing markup as
specified by the <option>-m</option> options. The <option>-p</option> option can be used to include the
SGML declaration and prolog in the output. The <option>-o</option> option can be used
to output other entities. The <option>-x</option> option can be used to expand entity
references.</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 Internation 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 bctf <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>Use the catalog entry file <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<replaceable>directory</replaceable></option></term>
<term><option>--directory=<replaceable>directory</replaceable></option></term>
<listitem>
<para>Search directory for files specified in system identifiers.
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>-E<replaceable>max_errors</replaceable></option></term>
<term><option>--max-errors=<replaceable>max_errors</replaceable></option></term>
<listitem>
<para>Exit after <replaceable>max_errors</replaceable> errors are encountered.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-f<replaceable>file</replaceable></option></term>
<term><option>--error-file=<replaceable>file</replaceable></option></term>
<listitem>
<para>Redirect errors to <replaceable>file</replaceable>.
This is useful mainly with shells that do not support redirection
of stderr.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-h</option></term>
<term><option>--hoist-omitted-tags</option></term>
<listitem>
<para>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
<option>-momittag</option> or <option>-x</option> <option>-x</option>.</para>
</listitem>
</varlistentry>
<varlistentry>
<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>-l</option></term>
<term><option>--lowercase</option></term>
<listitem>
<para>Prefer lower-case. Added names that were subject to upper-case
substitution will be converted to lower-case.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-m<replaceable>markup_option</replaceable></option></term>
<term><option>--markup-option=<replaceable>markup_option</replaceable></option></term>
<listitem>
<para>Change the markup in the output according to the value of
<replaceable>markup_option</replaceable> as follows:</para>
<para><option>omittag</option>
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.</para>
<para><option>shortref</option>
Replace short references by named entity references.</para>
<para><option>net</option>
Change null end-tags into unminimized end-tags, and
change net-enabling start-tags into unminimized
start-tags.</para>
<para><option>emptytag</option>
Change empty tags into unminimized tags.</para>
<para><option>unclosed</option>
Change unclosed tags into unminimized tags.</para>
<para><option>attname</option>
Add omitted attribute names and vis.</para>
<para><option>attvalue</option>
Add literal delimiters omitted from attribute values.</para>
<para><option>attspec</option>
Add omitted attribute specifications.</para>
<para><option>current</option>
Add omitted attribute specifications for current
attributes. This option is implied by the attspec option.</para>
<para><option>shorttag</option>
Equivalent to combination of net, emptytag, unclosed,
attname, attvalue and attspec options.</para>
<para><option>rank</option>
Add omitted rank suffixes.</para>
<para><option>reserved</option>
Put reserved names in upper-case.</para>
<para><option>ms</option>
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.</para>
<para>Multiple -m options are allowed.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-n</option></term>
<term><option>--error-numbers</option></term>
<listitem>
<para>Show error numbers in error messages.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-o<replaceable>name</replaceable></option></term>
<term><option>--output-entity=<replaceable>name</replaceable></option></term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-p</option></term>
<term><option>--output-prolog</option></term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-r</option></term>
<term><option>--raw</option></term>
<listitem>
<para>Don't perform any conversion on RSs and REs when outputting 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 as 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>
<term><option>--warning=<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>
<varlistentry>
<term><option>-x</option></term>
<term><option>--expand-references</option></term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Bugs</title>
<para>Omitted tags are added at the point where they are implied by the SGML
parser (except as modified by the <option>-h</option> option); this is often not quite
where they are wanted.</para>
<para>The case of general delimiters is not preserved.</para>
<para>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.</para>
<para>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. <command>ospam</command> will give a
warning when the first two conditions are met.</para>
</refsect1>
<refsect1>
<title>See Also</title>
<para><command>onsgmls(1)</command>, <command>ospent(1)</command>,
<command>osgmlnorm(1)</command>, <command>osx(1)</command></para>
</refsect1>
</refentry>
</section>
</article>
|
