/usr/share/doc/texinfo/html/Texinfo-Document-Structure.html is in texinfo-doc-nonfree 5.2.0-1.
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 142 | <!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 5.2, 26 September 2013),
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 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 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Texinfo 5.2: Texinfo Document Structure</title>
<meta name="description" content="GNU Texinfo 5.2: Texinfo Document Structure">
<meta name="keywords" content="GNU Texinfo 5.2: 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="Overview.html#Overview" rel="up" title="Overview">
<link href="Info-Files.html#Info-Files" rel="next" title="Info Files">
<link href="Adding-Output-Formats.html#Adding-Output-Formats" rel="previous" title="Adding Output Formats">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
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" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Texinfo-Document-Structure"></a>
<div class="header">
<p>
Next: <a href="Info-Files.html#Info-Files" accesskey="n" rel="next">Info Files</a>, Previous: <a href="Adding-Output-Formats.html#Adding-Output-Formats" accesskey="p" rel="previous">Adding Output Formats</a>, Up: <a href="Overview.html#Overview" accesskey="u" rel="up">Overview</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">1.5 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>Texinfo documents most usefully have a double structure, reflecting
the double purposes of printed and online output. For printed output
(DVI, PDF, …), with physical pages, there are chapters,
sections, subsections, etc. For online output (Info, HTML, …),
with interactive navigation and no physical pages, there are so-called
“nodes”.
</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>Each <em>node</em> has a name, and contains the discussion of one topic.
Along with the text for the user to read, each node also has pointers
to other nodes, identified in turn by their own names. Info readers
display one node at a time, and provide commands for the user to move
to related nodes. The HTML output can be similarly navigated.
</p>
<p>The names of child nodes are listed in a <em>menu</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 at the same level are formed into a chain with
‘Next’ and ‘Previous’ pointers. As you might imagine, the ‘Next’
pointer links to the next node (section), and the ‘Previous’ pointer
links to the previous node (section). 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 parent chapter. Each child node records the
parent node name as its ‘Up’ pointer. The last child has no ‘Next’
pointer, and the first child has the parent both as its ‘Previous’ and
as its ‘Up’ pointer.
</p>
<p>In addition to menus and ‘Next’, ‘Previous’, and ‘Up’ pointers,
Texinfo provides pointers of another kind for cross references, that
can be sprinkled throughout the text. This is usually the best way to
represent links that do not fit a hierarchical structure.
</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="Info-Files.html#Info-Files" accesskey="n" rel="next">Info Files</a>, Previous: <a href="Adding-Output-Formats.html#Adding-Output-Formats" accesskey="p" rel="previous">Adding Output Formats</a>, Up: <a href="Overview.html#Overview" accesskey="u" rel="up">Overview</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>
|