File: sx.htm

package info (click to toggle)
opensp 1.5pre5-5
  • links: PTS
  • area: main
  • in suites: woody
  • size: 6,860 kB
  • ctags: 8,918
  • sloc: cpp: 63,719; ansic: 10,494; sh: 7,592; makefile: 605; perl: 557; sed: 98
file content (159 lines) | stat: -rw-r--r-- 4,286 bytes parent folder | download | duplicates (2)
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
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN">
<HTML>
<HEAD>
<TITLE>OSX</TITLE>
</HEAD>
<BODY>
<H1>OSX</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>osx</CODE> [ <CODE>option...</CODE> ] <CODE><VAR>sysid...</VAR></CODE>
<H2>DESCRIPTION</H2>
<P>
Osx converts SGML to XML.
Osx parses and validates the SGML document contained in
<CODE><VAR>sysid...</VAR></CODE>
and writes an equivalent XML document to the standard output.
Osx will warn about SGML constructs which have no XML equivalent.
<H2>OPTIONS</H2>
<P>
The following options are available:
<DL>
<DT>
<CODE>-b<VAR>name</VAR></CODE>,
<CODE>--encoding=<VAR>name</VAR></CODE>
<DD>
Use the <A HREF="sysid.htm#encodings">BCTF</A> <VAR>name</VAR> for output.
By default osx uses UTF-8.
<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<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>-f<VAR>file</VAR></CODE>,
<CODE>--error-file=<VAR>file</VAR></CODE>
<DD>
Redirect errors to
<CODE><VAR>file</VAR></CODE>.
This is useful mainly with shells that do not support redirection
of stderr.
<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>-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>.
<DT>
<CODE>-x<VAR>option</VAR></CODE>,
<CODE>--xml-output-option=<VAR>option</VAR></CODE>
<DD>
Control the XML output according to the value of
<CODE><VAR>option</VAR></CODE> as follows:
<DL>
<DT>
<CODE>no-nl-in-tag</CODE>
<DD>
Don't use newlines inside start-tags.
Usually osx uses newlines inside start-tags so as to reduce the
probability of excessively long lines.
<DT>
<CODE>id</CODE>
<DD>
Output attribute declarations for ID attributes.
<DT>
<CODE>notation</CODE>
<DD>
Output declarations for notations.
<DT>
<CODE>ndata</CODE>
<DD>
Output declarations for external data entities.
XML requires these to be NDATA.
Osx will warn about CDATA and SDATA external data entities and
output them as NDATA entities.
<DT>
<CODE>cdata</CODE>
<DD>
Use XML CDATA sections for CDATA marked sections and for elements with a
declared content of CDATA.
<DT>
<CODE>comment</CODE>
<DD>
Output comment declarations.  Comment declarations in the DTD will not
be output.
<DT>
<CODE>lower</CODE>
<DD>
Prefer lower case.
Names that were subjected to upper-case substitution by SGML will be folded
to lower case.
This does not include reserved names; XML requires these to be in upper-case.
<DT>
<CODE>pi-escape</CODE>
<DD>
Escape <CODE>&amp;&lt;&gt;</CODE> in the contents of processing
instructions using the <CODE>amp</CODE>, <CODE>lt</CODE> and
<CODE>gt</CODE> entities.  This allows processing instructions to
contain the string <CODE>&gt;?</CODE>, but requires that applications
handle the escapes.
<DT>
<CODE>empty</CODE>
<DD>
Use the <CODE>&lt;<VAR>e</VAR>/&gt;</CODE> syntax for element types
<CODE><VAR>e</VAR></CODE> declared as EMPTY.
<DT>
<CODE>attlist</CODE>
<DD>
Output a ATTLIST declaration for every element specifying the type of
all attributes.  The default will always be <CODE>#IMPLIED</CODE>.
</DL>
<P>
Multiple
<CODE>-x</CODE>
options are allowed.
</DL>
</BODY>
</HTML>