1xml2ag(1) User Commands xml2ag(1)
2
6 xml2ag - XML to AutoGen Definiton Converter
7
9 xml2ag [-flags] [-flag [value]] [--option-name[[=| ]value]] [ <def-
10 file> ]
11 This program will convert any arbitrary XML file into equivalent Auto‐
13 Gen definitions, and invoke AutoGen.
14
16 The template will be derived from either:
17 * the --override-tpl command line option
18 * a top level XML attribute named, "template"
19 One or the other must be provided, or the program will exit with a
20 failure message.
21 The “base-name” for the output will similarly be either:
23 * the --base-name command line option
24 * the base name of the .xml file
25
27 All other options are derived from autogen
28 -O file, --output=file
29 Output file in lieu of AutoGen processing.
30 By default, the output is handed to an AutoGen for processing.
32 However, you may save the definitions to a file instead.
33 All other options
35 These options are mostly just passed throug to autogen. The one excep‐
36 tion is --override-tpl which replaces the default template in the out‐
37 put definitions. It does not get passed through on the command line.
38 -L dir, --templ-dirs=dir
40 Search for templates in DIR. This option may appear an unlim‐
41 ited number of times.
42 Pass-through AutoGen argument
44 -T tpl-file, --override-tpl=tpl-file
46 Use TPL-FILE for the template.
47 Pass-through AutoGen argument
49 --definitions=file
51 Read definitions from FILE.
52 Pass-through AutoGen argument
54 --shell=shell
56 name or path name of shell to use.
57 Pass-through AutoGen argument
59 -m, --no-fmemopen
61 Do not use in-mem streams.
62 Pass-through AutoGen argument
64 --equate=char-list
66 characters considered equivalent.
67 Pass-through AutoGen argument
69 -b name, --base-name=name
71 Specify NAME as the base name for output.
72 Pass-through AutoGen argument
74 --source-time
76 set mod times to latest source.
77 Pass-through AutoGen argument
79 --writable, --not-writable
81 Allow output files to be writable. The not-writable form will
82 disable the option.
83 Pass-through AutoGen argument
85 --loop-limit=lim
87 Limit on increment loops. This option takes an integer number
88 as its argument. The value of lim is constrained to being:
89 exactly -1, or
90 in the range 1 through 0x1000000
91 The default lim for this option is:
92 256
93 Pass-through AutoGen argument
95 -t seconds, --timeout=seconds
97 Limit server shell operations to SECONDS. This option takes an
98 integer number as its argument. The value of seconds is con‐
99 strained to being:
100 in the range 0 through 3600
101 Pass-through AutoGen argument
103 --trace=level
105 tracing level of detail. This option takes a keyword as its ar‐
106 gument. The argument sets an enumeration value that can be
107 tested by comparing them against the option value macro. The
108 available keywords are:
109 nothing debug-message server-shell
110 templates block-macros expressions
111 everything
112 or their numeric equivalent.
113 The default level for this option is:
115 nothing
116 Pass-through AutoGen argument
118 --trace-out=file
120 tracing output file or filter.
121 Pass-through AutoGen argument
123 --show-defs
125 Show the definition tree.
126 Pass-through AutoGen argument
128 --used-defines
130 Show the definitions used.
131 Pass-through AutoGen argument
133 -C, --core
135 Leave a core dump on a failure exit.
136 Many systems default to a zero sized core limit. If the system
138 has the sys/resource.h header and if this option is supplied,
139 then in the failure exit path, autogen will attempt to set the
140 soft core limit to whatever the hard core limit is. If that
141 does not work, then an administrator must raise the hard core
142 size limit.
143 -s suffix, --skip-suffix=suffix
145 Skip the file with this SUFFIX. This option may appear an un‐
146 limited number of times. This option must not appear in combi‐
147 nation with any of the following options: select-suffix.
148 Pass-through AutoGen argument
150 -o suffix, --select-suffix=suffix
152 specify this output suffix. This option may appear an unlimited
153 number of times.
154 Pass-through AutoGen argument
156 -D value, --define=value
158 name to add to definition list. This option may appear an un‐
159 limited number of times.
160 Pass-through AutoGen argument
162 -U name-pat, --undefine=name-pat
164 definition list removal pattern. This option may appear an un‐
165 limited number of times.
166 Pass-through AutoGen argument
168 -M type, --make-dep [type]
170 emit make dependency file. This option may appear an unlimited
171 number of times.
172 Pass-through AutoGen argument
174 -?, --help
176 Display usage information and exit.
177 -!, --more-help
179 Pass the extended usage information through a pager.
180 -v [{v|c|n --version [{v|c|n}]}]
182 Output version of program and exit. The default mode is `v', a
183 simple version. The `c' mode will print copyright information
184 and `n' will print the full copyright notice.
185
187 One of the following exit values will be returned:
188 0 (EXIT_SUCCESS)
190 Successful program execution.
191 1 (EXIT_FAILURE)
193 The operation failed or the command syntax was not valid.
194 70 (EX_SOFTWARE)
196 libopts had an internal operational error. Please report it to
197 autogen-users@lists.sourceforge.net. Thank you.
198
200 Bruce Korb
201
203 Copyright (C) 1992-2018 Bruce Korb all rights reserved. This program
204 is released under the terms of the GNU General Public License, version
205 3 or later.
206
208 Please send bug reports to: autogen-users@lists.sourceforge.net
209
211 This manual page was AutoGen-erated from the xml2ag option definitions.
212GNU AutoGen (5.18.16) 19 Jul 2023 xml2ag(1)