1XML2AG(1)                     Programmer's Manual                    XML2AG(1)
2
3
4

NAME

6       xml2ag - XML to AutoGen Definiton Converter
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

28       -O file, --output=file
29              Output file in lieu of AutoGen processing.
30
31              By default, the output is handed to an AutoGen  for  processing.
32              However, you may save the definitions to a file instead.
33
34       -L dir, --templ-dirs=dir
35              Template  search  directory  list.   This  option  may appear an
36              unlimited number of times.
37
38              Pass-through AutoGen argument
39
40       -T tpl-file, --override-tpl=tpl-file
41              Override template file.
42
43              Pass-through AutoGen argument
44
45       -l tpl-file, --lib-template=tpl-file
46              Library template file.  This option may appear an unlimited num‐
47              ber of times.
48
49              Pass-through AutoGen argument
50
51       -b name, --base-name=name
52              Base name for output file(s).
53
54              Pass-through AutoGen argument
55
56       --definitions=file
57              Definitions input file.
58
59              Pass-through AutoGen argument
60
61       -S file, --load-scheme=file
62              Scheme code file to load.
63
64              Pass-through AutoGen argument
65
66       -F file, --load-functions=file
67              Load scheme function library.
68
69              Pass-through AutoGen argument
70
71       -s suffix, --skip-suffix=suffix
72              Omit  the  file  with  this  suffix.   This option may appear an
73              unlimited number of times.
74
75              Pass-through AutoGen argument
76
77       -o suffix, --select-suffix[=suffix]
78              specify this output suffix.  This option may appear an unlimited
79              number of times.
80
81              Pass-through AutoGen argument
82
83       --source-time
84              set mod times to latest source.
85
86              Pass-through AutoGen argument
87
88       -m, --no-fmemopen
89              Do not use in-mem streams.
90
91              Pass-through AutoGen argument
92
93       --equate=char-list
94              characters considered equivalent.
95
96              Pass-through AutoGen argument
97
98       --writable, --not-writable
99              Allow  output  files to be writable.  The not-writable form will
100              disable the option.
101
102              Pass-through AutoGen argument
103
104       --loop-limit=lim
105              Limit on increment loops.  This option takes an  integer  number
106              as its argument.  The value of lim is constrained to being:
107                  exactly -1, or
108                  in the range  1 through 0x1000000
109              The default lim for this option is:
110                   256
111
112              Pass-through AutoGen argument
113
114       -t time-lim, --timeout=time-lim
115              Time limit for servers.  This option takes an integer number as
116              its argument.  The value of time-lim is constrained to being:
117                  in the range  0 through 3600
118
119              Pass-through AutoGen argument
120
121       --trace=level
122              tracing level of detail.  This option takes a keyword as its
123              argument.  The argument sets an enumeration value that can be
124              tested by comparing them against the option value macro.  The
125              available keywords are:
126                  nothing       debug-message server-shell
127                  templates     block-macros  expressions
128                  everything
129
130              The default level for this option is:
131                   nothing
132
133              Pass-through AutoGen argument
134
135       --trace-out=file
136              tracing output file or filter.
137
138              Pass-through AutoGen argument
139
140       --show-defs
141              Show the definition tree.
142
143              Pass-through AutoGen argument
144
145       -D value, --define=value
146              name to add to definition list.  This option may appear an
147              unlimited number of times.
148
149              Pass-through AutoGen argument
150
151       -U name-pat, --undefine=name-pat
152              definition list removal pattern.  This option may appear an
153              unlimited number of times.
154
155              Pass-through AutoGen argument
156
157       -?, --help
158              Display usage information and exit.
159
160       -!, --more-help
161              Extended usage information passed thru pager.
162
163       -v [{v|c|n}], --version[={v|c|n}]
164              Output version of program and exit.  The default mode is `v', a
165              simple version.  The `c' mode will print copyright information
166              and `n' will print the full copyright notice.
167

AUTHOR

169       Bruce Korb
170       Please send bug reports to:  autogen-users@lists.sourceforge.net
171
172
173       Released under the GNU General Public License.
174
175       This manual page was AutoGen-erated from the xml2ag option definitions.
176
177
178
179(GNU AutoGen 5.9.4)               2009-08-10                         XML2AG(1)