1xml2ag(1)                        User Commands                       xml2ag(1)
2
3
4

NAME

6       xml2ag - XML to AutoGen Definiton Converter
7

SYNOPSIS

9       xml2ag [-flag [value]]... [--opt-name[[=| ]value]]... [ <def-file> ]
10
11       This  program will convert any arbitrary XML file into equivalent Auto‐
12       Gen definitions, and invoke AutoGen.
13

DESCRIPTION

15       The template will be derived from either:
16       *  the --override-tpl command line option
17       *  a top level XML attribute named, "template"
18       One or the other must be provided, or the  program  will  exit  with  a
19       failure message.
20
21       The “base-name” for the output will similarly be either:
22       *  the --base-name command line option
23       *  the base name of the .xml file
24

OPTIONS

26   All other options are derived from autogen
27       -O file, --output=file
28              Output file in lieu of AutoGen processing.
29
30              By  default,  the output is handed to an AutoGen for processing.
31              However, you may save the definitions to a file instead.
32
33   All other options
34       These options are mostly just passed throug to autogen.  The one excep‐
35       tion  is --override-tpl which replaces the default template in the out‐
36       put definitions.  It does not get passed through on the command line.
37
38       -L dir, --templ-dirs=dir
39              Search for templates in DIR.  This option may appear  an  unlim‐
40              ited number of times.
41
42              Pass-through AutoGen argument
43
44       -T tpl-file, --override-tpl=tpl-file
45              Use TPL-FILE for the template.
46
47              Pass-through AutoGen argument
48
49       -l tpl-file, --lib-template=tpl-file
50              Load  AutoGen  macros  from TPL-FILE.  This option may appear an
51              unlimited number of times.
52
53              Pass-through AutoGen argument
54
55              NOTE: THIS OPTION IS DEPRECATED
56
57       --definitions=file
58              Read definitions from FILE.
59
60              Pass-through AutoGen argument
61
62       --shell=shell
63              name or path name of shell to use.
64
65              Pass-through AutoGen argument
66
67       -m, --no-fmemopen
68              Do not use in-mem streams.
69
70              Pass-through AutoGen argument
71
72       --equate=char-list
73              characters considered equivalent.
74
75              Pass-through AutoGen argument
76
77       -b name, --base-name=name
78              Specify NAME as the base name for output.
79
80              Pass-through AutoGen argument
81
82       --source-time
83              set mod times to latest source.
84
85              Pass-through AutoGen argument
86
87       --writable, --not-writable
88              Allow output files to be writable.  The not-writable  form  will
89              disable the option.
90
91              Pass-through AutoGen argument
92
93       --loop-limit=lim
94              Limit  on  increment loops.  This option takes an integer number
95              as its argument.  The value of lim is constrained to being:
96                  exactly -1, or
97                  in the range  1 through 0x1000000
98              The default lim for this option is:
99                   256
100
101              Pass-through AutoGen argument
102
103       -t seconds, --timeout=seconds
104              Limit server shell operations to SECONDS.  This option takes an
105              integer number as its argument.  The value of seconds is con‐
106              strained to being:
107                  in the range  0 through 3600
108
109              Pass-through AutoGen argument
110
111       --trace=level
112              tracing level of detail.  This option takes a keyword as its
113              argument.  The argument sets an enumeration value that can be
114              tested by comparing them against the option value macro.  The
115              available keywords are:
116                  nothing       debug-message server-shell
117                  templates     block-macros  expressions
118                  everything
119                  or their numeric equivalent.
120
121              The default level for this option is:
122                   nothing
123
124              Pass-through AutoGen argument
125
126       --trace-out=file
127              tracing output file or filter.
128
129              Pass-through AutoGen argument
130
131       --show-defs
132              Show the definition tree.
133
134              Pass-through AutoGen argument
135
136       --used-defines
137              Show the definitions used.
138
139              Pass-through AutoGen argument
140
141       -C, --core
142              Leave a core dump on a failure exit.
143
144              Many systems default to a zero sized core limit.  If the system
145              has the sys/resource.h header and if this option is supplied,
146              then in the failure exit path, autogen will attempt to set the
147              soft core limit to whatever the hard core limit is.  If that
148              does not work, then an administrator must raise the hard core
149              size limit.
150
151       -s suffix, --skip-suffix=suffix
152              Skip the file with this SUFFIX.  This option may appear an
153              unlimited number of times.  This option must not appear in com‐
154              bination with any of the following options: select-suffix.
155
156              Pass-through AutoGen argument
157
158       -o suffix, --select-suffix=suffix
159              specify this output suffix.  This option may appear an unlimited
160              number of times.
161
162              Pass-through AutoGen argument
163
164       -D value, --define=value
165              name to add to definition list.  This option may appear an
166              unlimited number of times.
167
168              Pass-through AutoGen argument
169
170       -U name-pat, --undefine=name-pat
171              definition list removal pattern.  This option may appear an
172              unlimited number of times.
173
174              Pass-through AutoGen argument
175
176       -M type, --make-dep[=type]
177              emit make dependency file.  This option may appear an unlimited
178              number of times.
179
180              Pass-through AutoGen argument
181
182       -?, --help
183              Display usage information and exit.
184
185       -!, --more-help
186              Pass the extended usage information through a pager.
187
188       -v [{v|c|n}], --version[={v|c|n}]
189              Output version of program and exit.  The default mode is `v', a
190              simple version.  The `c' mode will print copyright information
191              and `n' will print the full copyright notice.
192

EXIT STATUS

194       One of the following exit values will be returned:
195
196       0 (EXIT_SUCCESS)
197              Successful program execution.
198
199       1 (EXIT_FAILURE)
200              The operation failed or the command syntax was not valid.
201
202       70 (EX_SOFTWARE)
203              libopts had an internal operational error.  Please report it to
204              autogen-users@lists.sourceforge.net.  Thank you.
205

AUTHORS

207       Bruce Korb
208
210       Copyright (C) 1992-2013 Bruce Korb all rights reserved.  This program
211       is released under the terms of the GNU General Public License, version
212       3 or later.
213

BUGS

215       Please send bug reports to: autogen-users@lists.sourceforge.net
216

NOTES

218       This manual page was AutoGen-erated from the xml2ag option definitions.
219
220
221
222GNU AutoGen (5.18)                10 Jun 2014                        xml2ag(1)
Impressum