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 documents, briefly, 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      server-shell templates
127                  block-macros expressions  everything
128
129              The default level for this option is:
130                   nothing
131
132              Pass-through AutoGen argument
133
134       --trace-out=file
135              tracing output file or filter.
136
137              Pass-through AutoGen argument
138
139       --show-defs
140              Show the definition tree.
141
142              Pass-through AutoGen argument
143
144       -D value, --define=value
145              name to add to definition list.  This option may appear an
146              unlimited number of times.
147
148              Pass-through AutoGen argument
149
150       -U name-pat, --undefine=name-pat
151              definition list removal pattern.  This option may appear an
152              unlimited number of times.
153
154              Pass-through AutoGen argument
155
156       -?, --help
157              Display usage information and exit.
158
159       -!, --more-help
160              Extended usage information passed thru pager.
161
162       -v [{v|c|n}], --version[={v|c|n}]
163              Output version of program and exit.  The default mode is `v', a
164              simple version.  The `c' mode will print copyright information
165              and `n' will print the full copyright notice.
166

AUTHOR

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