blob: 72d2d3615b6dc549dd2b632c23d5b8b9ee307dee [file]
<!DOCTYPE html>
<html>
<!-- Created by Texinfo 6.8dev+dev, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual is for GNU Texinfo (version 6.8dev, 23 February 2022),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2022 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<title>Tree Structuring (GNU Texinfo 6.8dev)</title>
<meta name="description" content="Tree Structuring (GNU Texinfo 6.8dev)">
<meta name="keywords" content="Tree Structuring (GNU Texinfo 6.8dev)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Chapter-Structuring.html" rel="up" title="Chapter Structuring">
<link href="Structuring-Command-Types.html" rel="next" title="Structuring Command Types">
<style type="text/css">
<!--
div.example {margin-left: 3.2em}
-->
</style>
</head>
<body lang="en">
<div class="section-level-extent" id="Tree-Structuring">
<div class="nav-panel">
<p>
Next: <a href="Structuring-Command-Types.html" accesskey="n" rel="next">Structuring Command Types</a>, Up: <a href="Chapter-Structuring.html" accesskey="u" rel="up">Chapter Structuring</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Tree-Structure-of-Sections">4.1 Tree Structure of Sections</h3>
<a class="index-entry-id" id="index-Tree-structuring"></a>
<p>A Texinfo file is usually structured like a book with chapters,
sections, subsections, and the like. This structure can be visualized
as a tree (or rather as an upside-down tree) with the root at the top
and the levels corresponding to chapters, sections, subsection, and
subsubsections.
</p>
<p>Here is a diagram that shows a Texinfo file with three chapters, each
with two sections.
</p>
<div class="example">
<div class="group"><pre class="example-preformatted"> Top
|
-------------------------------------
| | |
Chapter 1 Chapter 2 Chapter 3
| | |
-------- -------- --------
| | | | | |
Section Section Section Section Section Section
1.1 1.2 2.1 2.2 3.1 3.2
</pre></div></div>
<p>In a Texinfo file that has this structure, the beginning of Chapter 2
would be written like this:
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">@node Chapter 2
@chapter Chapter 2
</pre></div></div>
<p>For purposes of example, here is how it would be written with
explicit node pointers:
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">@node Chapter 2, Chapter 3, Chapter 1, Top
@chapter Chapter 2
</pre></div></div>
<p>The chapter structuring commands are described in the sections that
follow; the <code class="code">@node</code> command is described in
the previous chapter (see <a class="pxref" href="Nodes.html">Nodes</a>).
</p>
</div>
</body>
</html>