/usr/share/doc/autogen-doc/autogen.html/Definitions.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 | <!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: Definitions</title>
<meta name="description" content="GNU AutoGen - The Automated Program Generator: Definitions">
<meta name="keywords" content="GNU AutoGen - The Automated Program Generator: Definitions">
<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="Definitions-File.html#Definitions-File" rel="up" title="Definitions File">
<link href="def_002dlist.html#def_002dlist" rel="next" title="def-list">
<link href="Identification.html#Identification" rel="prev" title="Identification">
<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="Definitions"></a>
<div class="header">
<p>
Next: <a href="Index-Assignments.html#Index-Assignments" accesskey="n" rel="next">Index Assignments</a>, Previous: <a href="Identification.html#Identification" accesskey="p" rel="prev">Identification</a>, Up: <a href="Definitions-File.html#Definitions-File" accesskey="u" rel="up">Definitions File</a> [<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="Named-Definitions"></a>
<h3 class="section">2.2 Named Definitions</h3>
<a name="index-definitions"></a>
<p>A name is a sequence of characters beginning with an alphabetic character
(<code>a</code> through <code>z</code>) followed by zero or more alpha-numeric
characters and/or separator characters: hyphen (<code>-</code>), underscore
(<code>_</code>) or carat (<code>^</code>). Names are case insensitive.
</p>
<p>Any name may have multiple values associated with it. Every name may be
considered a sparse array of one or more elements. If there is more than
one value, the values my be accessed by indexing the value with
<code>[index]</code> or by iterating over them using the FOR (see <a href="FOR.html#FOR">FOR</a>) AutoGen
macro on it, as described in the next chapter. Sparse arrays are specified
by specifying an index when defining an entry
(see <a href="Index-Assignments.html#Index-Assignments">Assigning an Index to a Definition</a>).
</p>
<p>There are two kinds of definitions, ‘<samp>simple</samp>’ and ‘<samp>compound</samp>’.
They are defined thus (see <a href="Full-Syntax.html#Full-Syntax">Full Syntax</a>):
</p>
<div class="example">
<pre class="example">compound_name '=' '{' definition-list '}' ';'
simple-name[2] '=' string ';'
no^text^name ';'
</pre></div>
<p><code>simple-name</code> has the third index (index number 2) defined here.
<code>No^text^name</code> is a simple definition with a shorthand empty string
value. The string values for definitions may be specified in any of
several formation rules.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="def_002dlist.html#def_002dlist" accesskey="1">def-list</a>:</td><td> </td><td align="left" valign="top">Definition List
</td></tr>
<tr><td align="left" valign="top">• <a href="double_002dquote_002dstring.html#double_002dquote_002dstring" accesskey="2">double-quote-string</a>:</td><td> </td><td align="left" valign="top">Double Quote String
</td></tr>
<tr><td align="left" valign="top">• <a href="single_002dquote_002dstring.html#single_002dquote_002dstring" accesskey="3">single-quote-string</a>:</td><td> </td><td align="left" valign="top">Single Quote String
</td></tr>
<tr><td align="left" valign="top">• <a href="simple_002dstring.html#simple_002dstring" accesskey="4">simple-string</a>:</td><td> </td><td align="left" valign="top">An Unquoted String
</td></tr>
<tr><td align="left" valign="top">• <a href="shell_002dgenerated.html#shell_002dgenerated" accesskey="5">shell-generated</a>:</td><td> </td><td align="left" valign="top">Shell Output String
</td></tr>
<tr><td align="left" valign="top">• <a href="scheme_002dgenerated.html#scheme_002dgenerated" accesskey="6">scheme-generated</a>:</td><td> </td><td align="left" valign="top">Scheme Result String
</td></tr>
<tr><td align="left" valign="top">• <a href="here_002dstring.html#here_002dstring" accesskey="7">here-string</a>:</td><td> </td><td align="left" valign="top">A Here String
</td></tr>
<tr><td align="left" valign="top">• <a href="concat_002dstring.html#concat_002dstring" accesskey="8">concat-string</a>:</td><td> </td><td align="left" valign="top">Concatenated Strings
</td></tr>
</table>
<a name="index-simple-definitions"></a>
<a name="index-compound-definitions"></a>
<hr>
<div class="header">
<p>
Next: <a href="Index-Assignments.html#Index-Assignments" accesskey="n" rel="next">Index Assignments</a>, Previous: <a href="Identification.html#Identification" accesskey="p" rel="prev">Identification</a>, Up: <a href="Definitions-File.html#Definitions-File" accesskey="u" rel="up">Definitions File</a> [<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>
|