/usr/share/doc/texinfo/html/Texinfo-Document-Structure.html is in texinfo-doc-nonfree 6.1.0-2.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.1, 6 February 2016),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016 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 the Front-Cover Texts being "A GNU Manual",
and with the Back-Cover Texts as in (a) below. A copy of the license
is included in the section entitled "GNU Free Documentation
License".
(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual. Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Texinfo 6.1: Texinfo Document Structure</title>
<meta name="description" content="GNU Texinfo 6.1: Texinfo Document Structure">
<meta name="keywords" content="GNU Texinfo 6.1: Texinfo Document Structure">
<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="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Nodes.html#Nodes" rel="up" title="Nodes">
<link href="Node-Names.html#Node-Names" rel="next" title="Node Names">
<link href="Nodes.html#Nodes" rel="prev" title="Nodes">
<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.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; 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="Texinfo-Document-Structure"></a>
<div class="header">
<p>
Next: <a href="Node-Names.html#Node-Names" accesskey="n" rel="next">Node Names</a>, Up: <a href="Nodes.html#Nodes" accesskey="u" rel="up">Nodes</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Texinfo-Document-Structure-1"></a>
<h3 class="section">4.1 Texinfo Document Structure</h3>
<a name="index-Texinfo-document-structure"></a>
<a name="index-Document-structure_002c-of-Texinfo"></a>
<a name="index-Structure_002c-of-Texinfo-documents"></a>
<a name="index-Double-structure_002c-of-Texinfo-documents"></a>
<a name="Two-Paths"></a>
<p>Nodes can contain <em>menus</em>, which contain the names of <em>child
nodes</em> within the parent node; for example, a node corresponding to a
chapter would have a menu of the sections in that chapter. The menus
allow the user to move to the child nodes in a natural way in the online
output.
</p>
<p>In addition, nodes contain <em>node pointers</em> that name other nodes.
The ‘Next’ and ‘Previous’ pointers form nodes at the same sectioning
level into a chain. As you might imagine, the ‘Next’ pointer links to
the next node, and the ‘Previous’ pointer links to the previous node.
Thus, for example, all the nodes that are at the level of sections
within a chapter are linked together, and the order in this chain
is the same as the order of the children in the menu of the parent
chapter. Each child node records the parent node name as its ‘Up’
pointer.
</p>
<a name="index-accesskey_002c-in-HTML-output-of-nodes"></a>
<p>The Info and HTML output from <code>makeinfo</code> for each node includes
links to the ‘Next’, ‘Previous’, and ‘Up’ nodes. The HTML also uses
the <code>accesskey</code> attribute with the values ‘<samp>n</samp>’, ‘<samp>p</samp>’, and
‘<samp>u</samp>’ respectively. This allows people using web browsers to
follow the navigation using (typically) <kbd>M-<var>letter</var></kbd>, e.g.,
<kbd>M-n</kbd> for the ‘Next’ node, from anywhere within the node.
Node pointers and menus provide structure for Info files just as
chapters, sections, subsections, and the like provide structure for
printed books. The two structures are theoretically distinct; in
practice, however, the tree structure of printed books is essentially
always used for the node and menu structure also, as this leads to a
document which is easiest to follow. See <a href="#Texinfo-Document-Structure">Texinfo Document Structure</a>.
</p>
<p>Typically, the sectioning structure and the node structure are
completely parallel, with one node for each chapter, section, etc.,
and with the nodes following the same hierarchical arrangement as the
sectioning. Thus, if a node is at the logical level of a chapter, its
child nodes are at the level of sections; similarly, the child nodes
of sections are at the level of subsections.
</p>
<p>Although it is technically possible to create Texinfo documents with
only one structure or the other, or for the two structures not to be
parallel, or for either the sectioning or node structure to be
abnormally formed, etc., this is <em>not at all recommended</em>. To
the best of our knowledge, all the Texinfo manuals currently in
general use do follow the conventional parallel structure.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Node-Names.html#Node-Names" accesskey="n" rel="next">Node Names</a>, Up: <a href="Nodes.html#Nodes" accesskey="u" rel="up">Nodes</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|