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
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.docbook.org/xml/4.5/docbookx.dtd"
[
<!ENTITY daps_command "daps-xmlformat">
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>
<refentry lang="en" id="daps-xmlformat">
<refentryinfo>
<productname>&daps_command;</productname>
<authorgroup>
<author>
<contrib>Developer</contrib>
<firstname>Frank</firstname>
<surname>Sundermeyer</surname>
<email>fsundermeyer@opensuse.org</email>
</author>
<author>
<contrib>Developer</contrib>
<firstname>Thomas</firstname>
<surname>Schraitle</surname>
<email>toms@opensuse.org</email>
</author>
<author>
<contrib>Developer</contrib>
<firstname>Stefan</firstname>
<surname>Knorr</surname>
</author>
<author>
<contrib>Previous Developer of susedoc</contrib>
<firstname>Berthold</firstname>
<surname>Gunreben</surname>
</author>
<author>
<contrib>Previous Developer of susedoc</contrib>
<firstname>Jana</firstname>
<surname>Jaeger</surname>
</author>
</authorgroup>
</refentryinfo>
<refmeta>
<refentrytitle>&daps_command;</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="date"><?dbtimestamp format="Y B d"?></refmiscinfo>
<refmiscinfo class="version">&dapsversion;</refmiscinfo>
<refmiscinfo class="manual">&dapsacr;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>&daps_command;</refname>
<refpurpose>
A program in the DAPS software package, a complete environment to build
HTML, PDF, ePUB and other formats from DocBook XML.
</refpurpose>
</refnamediv>
<refsect1 id="daps-xmlformat.description">
<title>Description</title>
<para>
This manual page documents briefly the
<filename>&daps_command;</filename> program.
</para>
<para>
The &daps_command; program is a wrapper around the xmlformat command that is
used to format XML-formatted files. Simply pass the file name to the
program on the command line. Use the --help switch to see a usage help,
like that below:
<literallayout>
Usage: xmlformat [options] xml-file
Options:
--help, -h
Print this message and exit.
--backup suffix -b suffix
Back up the input document, adding suffix to the input
filename to create the backup filename.
--canonized-output
Proceed only as far as the document canonization stage,
printing the result.
--check-parser
Parse the document into tokens and verify that their
concatenation is identical to the original input document.
This option suppresses further document processing.
--config-file file_name, -f file_name
Specify the configuration filename. If no file is named,
xmlformat uses the file named by the environment variable
XMLFORMAT_CONF, if it exists, or ./xmlformat.conf, if it
exists. Otherwise, xmlformat uses built-in formatting
options.
--in-place, -i
Format the document in place, replacing the contents of
the input file with the reformatted document. (It's a
good idea to use --backup along with this option.)
--show-config
Show configuration options after reading configuration
file. This option suppresses document processing.
--show-unconfigured-elements
Show elements that are used in the document but for
which no options were specified in the configuration
file. This option suppresses document output.
--verbose, -v
Be verbose about processing stages.
--version, -V
Show version information and exit.
</literallayout>
</para>
</refsect1>
<refsect1>
<title>This man page author</title>
<para>
<author>
<firstname>Filippo</firstname> <surname>Rusconi
<lopippo@debian.org></surname> <authorblurb> <para> This manual
page was written by Filippo Rusconi <lopippo@debian.org>
(initial writing 06 february 2019). Permission is granted to
copy, distribute and/or modify this document under the terms of the
GNU General Public License, Version 3, published by the Free
Software Foundation. </para>
<para>
On a Debian system the complete text of the GNU General
Public License version 3 can be found in the file
<filename>/usr/share/common-licenses/GPL\-3</filename>.
</para>
</authorblurb>
</author>
</para>
</refsect1>
</refentry>
|
