Lines Matching +full:- +full:- +full:output +full:- +full:document
1 '\" -*- coding: us-ascii -*-
10 xmlwf \- Determines if an XML document is well-formed
18 …-s\fR] [\fB-n\fR] [\fB-p\fR] [\fB-x\fR] [\fB-e \fIencoding\fB\fR] [\fB-w\fR] [\fB-d \fIoutput-dir\…
19 'in \n(.iu-\nxu
24 determine if an XML document is well-formed. It is
25 non-validating.
27 If you do not specify any files on the command-line, and you
30 .SH "WELL-FORMED DOCUMENTS"
31 A well-formed document must adhere to the
47 all other elements in the document. Only comments, white
58 If the document has a DTD, and it strictly complies with that
59 DTD, then the document is also considered \fIvalid\fR.
60 \fBxmlwf\fR is a non-validating parser --
62 external entities (see the \*(T<\fB\-x\fR\*(T> option).
65 separately ("\*(T<\fB\-d\fR\*(T> output") or concatenated with the
66 option ("\*(T<\fB\-d\fR\*(T>output"). \fBxmlwf\fR
69 \*(T<\fB\-c\fR\*(T>
70 If the input file is well-formed and \fBxmlwf\fR
72 the output directory unchanged.
73 This implies no namespaces (turns off \*(T<\fB\-n\fR\*(T>) and
74 requires \*(T<\fB\-d\fR\*(T> to specify an output directory.
76 \*(T<\fB\-d output\-dir\fR\*(T>
79 By default, \*(T<\fB\-d\fR\*(T> outputs a canonical representation
81 You can select different output formats using \*(T<\fB\-c\fR\*(T>,
82 \*(T<\fB\-m\fR\*(T> and \*(T<\fB\-N\fR\*(T>.
84 The output filenames will
87 output file does not go into the same directory as the input
89 input file before it generates the output file (just like running
92 Two structurally equivalent XML documents have a byte-for-byte
99 \*(T<\fB\-e encoding\fR\*(T>
100 Specifies the character encoding for the document, overriding
101 any document encoding declaration. \fBxmlwf\fR
102 supports four built-in encodings:
103 \*(T<US\-ASCII\*(T>,
104 \*(T<UTF\-8\*(T>,
105 \*(T<UTF\-16\*(T>, and
106 \*(T<ISO\-8859\-1\*(T>.
107 Also see the \*(T<\fB\-w\fR\*(T> option.
109 \*(T<\fB\-m\fR\*(T>
112 Requires \*(T<\fB\-d\fR\*(T> to specify an output file.
114 \*(T<\fB\-n\fR\*(T>
116 \*(T<\fB\-c\fR\*(T> disables namespaces.
118 \*(T<\fB\-N\fR\*(T>
119 Adds a doctype and notation declarations to canonical XML output.
120 This matches the example output used by the formal XML test cases.
121 Requires \*(T<\fB\-d\fR\*(T> to specify an output file.
123 \*(T<\fB\-p\fR\*(T>
128 entities. \*(T<\fB\-p\fR\*(T> tells it to always parse them.
129 \*(T<\fB\-p\fR\*(T> implies \*(T<\fB\-x\fR\*(T>.
131 \*(T<\fB\-r\fR\*(T>
132 Normally \fBxmlwf\fR memory-maps the XML file
135 \*(T<\fB\-r\fR\*(T> turns off memory-mapping and uses normal file
137 Of course, memory-mapping is automatically turned off
140 Use of memory-mapping can cause some platforms to report
146 \*(T<\fB\-s\fR\*(T>
147 Prints an error if the document is not standalone.
148 A document is standalone if it has no external subset and no
151 \*(T<\fB\-t\fR\*(T>
156 \*(T<\fB\-t\fR\*(T> turns off most of the output options
157 (\*(T<\fB\-d\fR\*(T>, \*(T<\fB\-m\fR\*(T>, \*(T<\fB\-c\fR\*(T>, ...).
159 \*(T<\fB\-v\fR\*(T>
161 information on the compile-time configuration of the library, and
164 \*(T<\fB\-w\fR\*(T>
168 \*(T<\fB\-w\fR\*(T>, xmlwf will try to use a Windows code
169 page. See also \*(T<\fB\-e\fR\*(T>.
171 \*(T<\fB\-x\fR\*(T>
174 Non-validating parsers are not required to resolve external
193 <!ENTITY header SYSTEM "header\-&vers;.xml"> (parsed)
197 \*(T<\fB\-\-\fR\*(T>
204 xmlwf \-\- \-myfile.xml
208 \*(T<\fI\-myfile.xml\fR\*(T>.
212 .SH OUTPUT
213 If an input file is not well-formed,
215 the problem to standard output. If a file is well formed,
219 \fBxmlwf\fR returns a 0 - noerr result,
220 even if the file is not well-formed. There is no good way for
222 check a file -- it must parse \fBxmlwf\fR's
223 standard output.
225 The errors should go to standard error, not standard output.
227 There should be a way to get \*(T<\fB\-d\fR\*(T> to send its
228 output to standard output rather than forcing the user to send
232 \*(T<\fB\-d\fR\*(T>, \*(T<\fB\-c\fR\*(T>, and
233 \*(T<\fB\-m\fR\*(T> options. If someone could explain it to
240 http://www.hcrc.ed.ac.uk/~richard/xml\-check.html
249 The W3 XML specification: http://www.w3.org/TR/REC\-xml
254 granted to copy, distribute and/or modify this document under