Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017
 
 

xml2ag (1)

Name

xml2ag - XML to AutoGen Definiton Converter

Synopsis

xml2ag [-flag [value]]... [--opt-name [[=| ]value]]...
[ <def-file> ]

This  program will convert any arbitrary XML file into equivalent Auto-
Gen definitions, and invoke AutoGen.

Description

XML2AG(1)                     Programmer's Manual                    XML2AG(1)



NAME
       xml2ag - XML to AutoGen Definiton Converter

SYNOPSIS
       xml2ag [-flag [value]]... [--opt-name [[=| ]value]]...
               [ <def-file> ]

       This  program will convert any arbitrary XML file into equivalent Auto-
       Gen definitions, and invoke AutoGen.

DESCRIPTION
       This manual page documents, briefly, the xml2ag command.  The  template
       will be derived from either:
       *  the --override-tpl command line option
       *  a top level XML attribute named, "template"
       One  or  the  other  must  be provided, or the program will exit with a
       failure message.

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

OPTIONS
       -O file, --output=file
              Output file in lieu of AutoGen processing.

              By default, the output is handed to an AutoGen  for  processing.
              However, you may save the definitions to a file instead.

       -L dir, --templ-dirs=dir
              Template  search  directory  list.   This  option  may appear an
              unlimited number of times.

              Pass-through AutoGen argument

       -T tpl-file, --override-tpl=tpl-file
              Override template file.

              Pass-through AutoGen argument

       -l tpl-file, --lib-template=tpl-file
              Library template file.  This option may appear an unlimited num-
              ber of times.

              Pass-through AutoGen argument

       -b name, --base-name=name
              Base name for output file(s).

              Pass-through AutoGen argument

       --definitions=file
              Definitions input file.

              Pass-through AutoGen argument

       -S file, --load-scheme=file
              Scheme code file to load.

              Pass-through AutoGen argument

       -F file, --load-functions=file
              Load scheme function library.

              Pass-through AutoGen argument

       -s suffix, --skip-suffix=suffix
              Omit  the  file  with  this  suffix.   This option may appear an
              unlimited number of times.

              Pass-through AutoGen argument

       -o suffix, --select-suffix[=suffix]
              specify this output suffix.  This option may appear an unlimited
              number of times.

              Pass-through AutoGen argument

       --source-time
              set mod times to latest source.

              Pass-through AutoGen argument

       -m, --no-fmemopen
              Do not use in-mem streams.

              Pass-through AutoGen argument

       --equate=char-list
              characters considered equivalent.

              Pass-through AutoGen argument

       --writable, --not-writable
              Allow  output  files to be writable.  The not-writable form will
              disable the option.

              Pass-through AutoGen argument

       --loop-limit=lim
              Limit on increment loops.  This option takes an  integer  number
              as its argument.  The value of lim is constrained to being:
                  exactly -1, or
                  in the range  1 through 0x1000000
              The default lim for this option is:
                   256

              Pass-through AutoGen argument

       -t time-lim, --timeout=time-lim
              Time limit for servers.  This option takes an integer number as
              its argument.  The value of time-lim is constrained to being:
                  in the range  0 through 3600

              Pass-through AutoGen argument

       --trace=level
              tracing level of detail.  This option takes a keyword as its
              argument.  The argument sets an enumeration value that can be
              tested by comparing them against the option value macro.  The
              available keywords are:
                  nothing      server-shell templates
                  block-macros expressions  everything

              The default level for this option is:
                   nothing

              Pass-through AutoGen argument

       --trace-out=file
              tracing output file or filter.

              Pass-through AutoGen argument

       --show-defs
              Show the definition tree.

              Pass-through AutoGen argument

       -D value, --define=value
              name to add to definition list.  This option may appear an
              unlimited number of times.

              Pass-through AutoGen argument

       -U name-pat, --undefine=name-pat
              definition list removal pattern.  This option may appear an
              unlimited number of times.

              Pass-through AutoGen argument

       -?, --help
              Display usage information and exit.

       -!, --more-help
              Extended usage information passed thru pager.

       -v [{v|c|n}], --version[={v|c|n}]
              Output version of program and exit.  The default mode is `v', a
              simple version.  The `c' mode will print copyright information
              and `n' will print the full copyright notice.

AUTHOR
       Bruce Korb
       Please send bug reports to:  autogen-users@lists.sourceforge.net


       Released under the GNU General Public License.

       This manual page was AutoGen-erated from the xml2ag option definitions.



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       +---------------+-------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE      |
       +---------------+-------------------------+
       |Availability   | developer/build/autogen |
       +---------------+-------------------------+
       |Stability      | Uncommitted             |
       +---------------+-------------------------+
NOTES
       This software was built from source available at
       https://java.net/projects/solaris-userland.  The original community
       source was downloaded from  http://ftp.gnu.org/gnu/autogen/rel5.9/auto-
       gen-5.9.tar.gz

       Further information about this software can be found on the open source
       community website at http://www.gnu.org/software/autogen/.



(GNU AutoGen 5.9)                 2015-08-19                         XML2AG(1)