1xml2ag(1) User Commands xml2ag(1)
2
3
4
6 xml2ag - XML to AutoGen Definiton Converter
7
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
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
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
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
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
215 Please send bug reports to: autogen-users@lists.sourceforge.net
216
218 This manual page was AutoGen-erated from the xml2ag option definitions.
219
220
221
222GNU AutoGen (5.18) 10 Jun 2014 xml2ag(1)