autogen-doc 1:5.18.7-3 / usr / share / doc / autogen-doc / autogen.html / xml2ag-Invocation.html

This file is indexed.

/usr/share/doc/autogen-doc/autogen.html/xml2ag-Invocation.html is in autogen-doc 1:5.18.7-3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU AutoGen version 5.18, updated December 2015.

Copyright (C) 1992-2015 by Bruce Korb.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. -->
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU AutoGen - The Automated Program Generator: xml2ag Invocation</title>

<meta name="description" content="GNU AutoGen - The Automated Program Generator: xml2ag Invocation">
<meta name="keywords" content="GNU AutoGen - The Automated Program Generator: xml2ag Invocation">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="AutoOpts.html#AutoOpts" rel="index" title="AutoOpts">
<link href="Function-Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Add_002dOns.html#Add_002dOns" rel="up" title="Add-Ons">
<link href="xml2ag-usage.html#xml2ag-usage" rel="next" title="xml2ag usage">
<link href="getdefs-See-Also.html#getdefs-See-Also" rel="prev" title="getdefs See Also">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="xml2ag-Invocation"></a>
<div class="header">
<p>
Next: <a href="snprintfv.html#snprintfv" accesskey="n" rel="next">snprintfv</a>, Previous: <a href="getdefs-Invocation.html#getdefs-Invocation" accesskey="p" rel="prev">getdefs Invocation</a>, Up: <a href="Add_002dOns.html#Add_002dOns" accesskey="u" rel="up">Add-Ons</a> &nbsp; [<a href="Function-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AutoOpts.html#AutoOpts" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Invoking-xml2ag"></a>
<h3 class="section">8.7 Invoking xml2ag</h3>
<a name="index-xml2ag"></a>
<a name="index-XML-to-AutoGen-Definiton-Converter"></a>

<p>This program will convert any arbitrary XML file into equivalent
AutoGen definitions, and invoke AutoGen.
The template used will be derived from either:
</p><ul>
<li> The <strong>&ndash;override-tpl</strong> command line option
</li><li> A top level XML attribute named, &quot;<code>template</code>&quot;
</li></ul>
<p>One or the other <strong>must</strong> be provided, or the program will
exit with a failure message.
</p>
<p>The <em>base-name</em> for the output will similarly be either:
</p><ul>
<li> The <strong>&ndash;base-name</strong> command line option.
</li><li> The base name of the <samp>.xml</samp> file.
</li></ul>

<p>The definitions derived from XML generally have an extra layer
of definition.  Specifically, this XML input:
</p><div class="example">
<pre class="example">&lt;mumble attr=&quot;foo&quot;&gt;
  mumble-1
  &lt;grumble&gt;
  grumble, grumble, grumble.
&lt;/grumble&gt;mumble, mumble
&lt;/mumble&gt;
</pre></div>
<p>Will get converted into this:
</p><div class="example">
<pre class="example">mumble = {
  grumble = {
    text = 'grumble, grumble, grumble';
  };
  text = 'mumble-1';
  text = 'mumble, mumble';
};
</pre></div>
<p>Please notice that some information is lost.  AutoGen cannot tell that
&quot;grumble&quot; used to lie between the mumble texts.  Also please note that
you cannot assign:
</p><div class="example">
<pre class="example">grumble = 'grumble, grumble, grumble.';
</pre></div>
<p>because if another &quot;grumble&quot; has an attribute or multiple texts,
it becomes impossible to have the definitions be the same type
(compound or text values).
</p>
<p>This section was generated by <strong>AutoGen</strong>,
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>xml2ag</code> program.
This software is released under the GNU General Public License, version 3 or later.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="xml2ag-usage.html#xml2ag-usage" accesskey="1">xml2ag usage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">xml2ag help/usage (<samp>--help</samp>)
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="xml2ag-the_002dxml2ag_002doption.html#xml2ag-the_002dxml2ag_002doption" accesskey="2">xml2ag the-xml2ag-option</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">the-xml2ag-option options
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="xml2ag-autogen_002doptions.html#xml2ag-autogen_002doptions" accesskey="3">xml2ag autogen-options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">autogen-options options
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="xml2ag-exit-status.html#xml2ag-exit-status" accesskey="4">xml2ag exit status</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">exit status
</td></tr>
</table>

<hr>
<div class="header">
<p>
Next: <a href="snprintfv.html#snprintfv" accesskey="n" rel="next">snprintfv</a>, Previous: <a href="getdefs-Invocation.html#getdefs-Invocation" accesskey="p" rel="prev">getdefs Invocation</a>, Up: <a href="Add_002dOns.html#Add_002dOns" accesskey="u" rel="up">Add-Ons</a> &nbsp; [<a href="Function-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AutoOpts.html#AutoOpts" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>

APT Browse - Built by Thomas Orozco.