Lines Matching +full:- +full:- +full:option
1 <!--
10 Copyright (c) 2002-2003 Fred L. Drake, Jr. <fdrake@users.sourceforge.net>
12 Copyright (c) 2016-2021 Sebastian Pipping <sebastian@pipping.org>
19 -->
20 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
21 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
24 <!-- Please adjust the date whenever revising the manpage. -->
59 <refpurpose>Determines if an XML document is well-formed</refpurpose>
69 <arg choice="plain"><option>-h</option></arg>
73 <arg choice="plain"><option>-v</option></arg>
82 determine if an XML document is well-formed. It is
83 non-validating.
87 If you do not specify any files on the command-line, and you
95 <title>WELL-FORMED DOCUMENTS</title>
98 A well-formed document must adhere to the
132 <command>&dhpackage;</command> is a non-validating parser --
134 external entities (see the <option>-x</option> option).
142 When an option includes an argument, you may specify the argument either
143 separately ("<option>-d</option> <replaceable>output</replaceable>") or concatenated with the
144 option ("<option>-d</option><replaceable>output</replaceable>"). <command>&dhpackage;</command>
151 <term><option>-a</option> <replaceable>factor</replaceable></term>
171 If you ever need to increase this value for non-attack payload,
178 <term><option>-b</option> <replaceable>bytes</replaceable></term>
188 If you ever need to increase this value for non-attack payload,
195 <term><option>-c</option></term>
198 If the input file is well-formed and <command>&dhpackage;</command>
201 This implies no namespaces (turns off <option>-n</option>) and
202 requires <option>-d</option> to specify an output directory.
208 <term><option>-d</option> <replaceable>output-dir</replaceable></term>
213 By default, <option>-d</option> outputs a canonical representation
215 You can select different output formats using <option>-c</option>,
216 <option>-m</option> and <option>-N</option>.
228 Two structurally equivalent XML documents have a byte-for-byte
239 <term><option>-e</option> <replaceable>encoding</replaceable></term>
244 supports four built-in encodings:
245 <literal>US-ASCII</literal>,
246 <literal>UTF-8</literal>,
247 <literal>UTF-16</literal>, and
248 <literal>ISO-8859-1</literal>.
249 Also see the <option>-w</option> option.
255 <term><option>-k</option></term>
270 <term><option>-m</option></term>
275 Requires <option>-d</option> to specify an output file.
281 <term><option>-n</option></term>
285 <option>-c</option> disables namespaces.
291 <term><option>-N</option></term>
296 Requires <option>-d</option> to specify an output file.
302 <term><option>-p</option></term>
310 entities. <option>-p</option> tells it to always parse them.
311 <option>-p</option> implies <option>-x</option>.
317 <term><option>-r</option></term>
320 Normally <command>&dhpackage;</command> memory-maps the XML file
323 <option>-r</option> turns off memory-mapping and uses normal file
325 Of course, memory-mapping is automatically turned off
329 Use of memory-mapping can cause some platforms to report
339 <term><option>-s</option></term>
350 <term><option>-t</option></term>
357 <option>-t</option> turns off most of the output options
358 (<option>-d</option>, <option>-m</option>, <option>-c</option>, ...).
364 <term><option>-v</option></term>
368 information on the compile-time configuration of the library, and
375 <term><option>-w</option></term>
381 <option>-w</option>, <command>&dhpackage;</command> will try to use a Windows code
382 page. See also <option>-e</option>.
388 <term><option>-x</option></term>
394 Non-validating parsers are not required to resolve external
413 <!ENTITY header SYSTEM "header-&vers;.xml"> (parsed)
422 <term><option>--</option></term>
430 &dhpackage; -- -myfile.xml
434 <filename>-myfile.xml</filename>.
449 <command>&dhpackage;</command> outputs nothing for files which are problem-free.
450 If any input file is not well-formed, or if the output for any
455 If the <option>-k</option> option is not provided, <command>&dhpackage;</command>
456 halts upon encountering a well-formedness or output-file error.
457 If <option>-k</option> is provided, <command>&dhpackage;</command> continues
464 …<para>For option <option>-v</option> or <option>-h</option>, <command>&dhpackage;</command> always…
467 <term><option>0</option></term>
468 …<listitem><para>The input files are well-formed and the output (if requested) was written successf…
472 <term><option>1</option></term>
477 <term><option>2</option></term>
478 <listitem><para>One or more input files were not well-formed or could not be parsed.</para>
482 <term><option>3</option></term>
483 …<listitem><para>If using the <option>-d</option> option, an error occurred opening an output file.…
487 <term><option>4</option></term>
488 …<listitem><para>There was a command-line argument error in how <command>&dhpackage;</command> was …
502 There should be a way to get <option>-d</option> to send its
508 <option>-d</option>, <option>-c</option>, and
509 <option>-m</option> options. If someone could explain it to
520 The W3 XML 1.0 specification (fourth edition): https://www.w3.org/TR/2006/REC-xml-20060816/