83 |
<p>Here is a copy of the diagram shown earlier that illustrates a Texinfo |
<p>Here is a copy of the diagram shown earlier that illustrates a Texinfo |
84 |
file with three chapters, each of which contains two sections. |
file with three chapters, each of which contains two sections. |
85 |
</p> |
</p> |
86 |
<p>The "root" is at the top of the diagram and the "leaves" are at the |
<p>The “root” is at the top of the diagram and the “leaves” are at the |
87 |
bottom. This is how such a diagram is drawn conventionally; it |
bottom. This is how such a diagram is drawn conventionally; it |
88 |
illustrates an upside-down tree. For this reason, the root node is |
illustrates an upside-down tree. For this reason, the root node is |
89 |
called the `Top' node, and `Up' node pointers carry you closer to the |
called the `Top' node, and `Up' node pointers carry you closer to the |
106 |
@comment node-name, next, previous, up |
@comment node-name, next, previous, up |
107 |
</pre></td></tr></table> |
</pre></td></tr></table> |
108 |
|
|
109 |
<p>This <code>@node</code> line says that the name of this node is "Chapter |
<p>This <code>@node</code> line says that the name of this node is “Chapter |
110 |
2", the name of the `Next' node is "Chapter 3", the name of the |
2”, the name of the `Next' node is “Chapter 3”, the name of the |
111 |
`Previous' node is "Chapter 1", and the name of the `Up' node is |
`Previous' node is “Chapter 1”, and the name of the `Up' node is |
112 |
"Top". You can omit writing out these node names if your document is |
“Top”. You can omit writing out these node names if your document is |
113 |
hierarchically organized (see section <a href="makeinfo-Pointer-Creation.html#SEC95">Creating Pointers with <code>makeinfo</code></a>), but the |
hierarchically organized (see section <a href="makeinfo-Pointer-Creation.html#SEC95">Creating Pointers with <code>makeinfo</code></a>), but the |
114 |
pointer relationships still obtain. |
pointer relationships still obtain. |
115 |
</p> |
</p> |
116 |
<blockquote><p><strong>Please Note:</strong> `Next' refers to the next node at the same |
<blockquote><p><strong>Please Note:</strong> `Next' refers to the next node at the same |
117 |
hierarchical level in the manual, not necessarily to the next node |
hierarchical level in the manual, not necessarily to the next node |
118 |
within the Texinfo file. In the Texinfo file, the subsequent node may |
within the Texinfo file. In the Texinfo file, the subsequent node may |
119 |
be at a lower level--a section-level node most often follows a |
be at a lower level—a section-level node most often follows a |
120 |
chapter-level node, for example. `Next' and `Previous' refer to nodes |
chapter-level node, for example. `Next' and `Previous' refer to nodes |
121 |
at the <em>same</em> hierarchical level. (The `Top' node contains the |
at the <em>same</em> hierarchical level. (The `Top' node contains the |
122 |
exception to this rule. Since the `Top' node is the only node at that |
exception to this rule. Since the `Top' node is the only node at that |
139 |
@comment node-name, next, previous, up |
@comment node-name, next, previous, up |
140 |
</pre></td></tr></table> |
</pre></td></tr></table> |
141 |
<p>In Info format, the `Next' and `Previous' pointers of a node usually |
<p>In Info format, the `Next' and `Previous' pointers of a node usually |
142 |
lead to other nodes at the same level--from chapter to chapter or from |
lead to other nodes at the same level—from chapter to chapter or from |
143 |
section to section (sometimes, as shown, the `Previous' pointer points |
section to section (sometimes, as shown, the `Previous' pointer points |
144 |
up); an `Up' pointer usually leads to a node at the level above (closer |
up); an `Up' pointer usually leads to a node at the level above (closer |
145 |
to the `Top' node); and a `Menu' leads to nodes at a level below (closer |
to the `Top' node); and a `Menu' leads to nodes at a level below (closer |
151 |
<code>@node</code> line with a comment line that reminds you which pointer is |
<code>@node</code> line with a comment line that reminds you which pointer is |
152 |
which.) |
which.) |
153 |
</p> |
</p> |
154 |
<p>Here is the beginning of the chapter in this manual called "Ending a |
<p>Here is the beginning of the chapter in this manual called “Ending a |
155 |
Texinfo File". This shows an <code>@node</code> line followed by a comment |
Texinfo File”. This shows an <code>@node</code> line followed by a comment |
156 |
line, an <code>@chapter</code> line, and then by indexing lines. |
line, an <code>@chapter</code> line, and then by indexing lines. |
157 |
</p> |
</p> |
158 |
<table><tr><td> </td><td><pre class="example">@node Ending a File, Structuring, Beginning a File, Top |
<table><tr><td> </td><td><pre class="example">@node Ending a File, Structuring, Beginning a File, Top |