OS Manuals

/usr/bin/xml2ag

An automated text file generator

From autogen 5.18.16-r6 (enterprise-packages), captured 2026-11-08 by running xml2ag --help (exit 0). permalink

xml2ag (GNU AutoGen) - XML to AutoGen Definiton Converter - Ver. 5.18.16
Usage:  xml2ag [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ <def-file> ]

All other options are derived from autogen:

  Flg Arg Option-Name    Description
   -O Str output         Output file in lieu of AutoGen processing

All other options:

  Flg Arg Option-Name    Description
   -L Str templ-dirs     Search for templates in DIR
				- may appear multiple times
   -T Str override-tpl   Use TPL-FILE for the template
      Str definitions    Read definitions from FILE
      Str shell          name or path name of shell to use
   -m no  no-fmemopen    Do not use in-mem streams
      Str equate         characters considered equivalent
   -b Str base-name      Specify NAME as the base name for output
      no  source-time    set mod times to latest source
      no  writable       Allow output files to be writable
				- disabled as '--not-writable'
      Num loop-limit     Limit on increment loops
				- is scalable with a suffix: k/K/m/M/g/G/t/T
				- it must lie in one of the ranges:
				  -1 exactly, or
				  1 to 16777216
   -t Num timeout        Limit server shell operations to SECONDS
				- it must be in the range:
				  0 to 3600
      KWd trace          tracing level of detail
      Str trace-out      tracing output file or filter
      no  show-defs      Show the definition tree
      no  used-defines   Show the definitions used
   -C no  core           Leave a core dump on a failure exit
   -s Str skip-suffix    Skip the file with this SUFFIX
				- prohibits the option 'select-suffix'
				- may appear multiple times
   -o Str select-suffix  specify this output suffix
				- may appear multiple times
   -D Str define         name to add to definition list
				- may appear multiple times
   -U Str undefine       definition list removal pattern
				- an alternate for 'define'
   -M opt make-dep       emit make dependency file
				- may appear multiple times

Version, usage and configuration options:

  Flg Arg Option-Name    Description
   -v opt version        output version information and exit
   -? no  help           display extended usage information and exit
   -! no  more-help      extended usage information passed thru pager

Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
This program will convert any arbitrary XML file into equivalent AutoGen
definitions, and invoke AutoGen.

The valid "trace" option keywords are:
  nothing       debug-message server-shell  templates     block-macros
  expressions   everything
  or an integer from 0 through 6
The template will be derived from either: * the ``--override-tpl'' command
line option * a top level XML attribute named, "template"

The ``base-name'' for the output will similarly be either: * the
``--base-name'' command line option * the base name of the .xml file

Please send bug reports to:  <autogen-users@lists.sourceforge.net>
Options (25)
OptionDescriptionSource
-O, --output StrOutput file in lieu of AutoGen processing.help + man
-L, --templ-dirs StrSearch for templates in DIR.help + man
-T, --override-tpl StrUse TPL-FILE for the template Str definitions Read definitions from FILE Str shell name or path name of shell to usehelp + man
-m, --no-fmemopen nono-fmemopen Do not use in-mem streams Str equate characters considered equivalenthelp + man
-b, --base-name StrSpecify NAME as the base name for output no source-time set mod times to latest source no writable Allow output files to be writablehelp + man
-t, --timeout NumLimit server shell operations to SECONDS.help + man
-C, --core nocore Leave a core dump on a failure exithelp + man
-s, --skip-suffix StrSkip the file with this SUFFIX.help + man
-o, --select-suffix Strspecify this output suffix.help + man
-D, --define Strname to add to definition list.help + man
-U, --undefine Strdefinition list removal pattern.help + man
-M optemit make dependency filehelp
-v optoutput version information and exithelp
-?, --help nohelp display extended usage information and exithelp + man
--definitions fileRead definitions from FILE. (in the manual page but not in --help)man
--shell shellname or path name of shell to use. (in the manual page but not in --help)man
--equate char-listcharacters considered equivalent. (in the manual page but not in --help)man
--source-timeset mod times to latest source. (in the manual page but not in --help)man
--writable, --not-writableAllow output files to be writable. (in the manual page but not in --help)man
--loop-limit limLimit on increment loops. (in the manual page but not in --help)man
--trace leveltracing level of detail. (in the manual page but not in --help)man
--trace-out filetracing output file or filter. (in the manual page but not in --help)man
--show-defsShow the definition tree. (in the manual page but not in --help)man
--used-definesShow the definitions used. (in the manual page but not in --help)man
--more-helpPass the extended usage information through a pager. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.