texinfo-doc-nonfree 6.5.0-1 / usr / share / doc / texinfo / html / makeinfo-Pointer-Creation.html

This file is indexed.

/usr/share/doc/texinfo/html/makeinfo-Pointer-Creation.html is in texinfo-doc-nonfree 6.5.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
<!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.5, 25 August 2017),
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.4.90, http://www.gnu.org/software/texinfo/ -->
<head>
<title>makeinfo Pointer Creation (GNU Texinfo 6.5)</title>

<meta name="description" content="makeinfo Pointer Creation (GNU Texinfo 6.5)">
<meta name="keywords" content="makeinfo Pointer Creation (GNU Texinfo 6.5)">
<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="Menus.html#Menus" rel="next" title="Menus">
<link href="Node-Menu-Illustration.html#Node-Menu-Illustration" rel="prev" title="Node Menu Illustration">
<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="makeinfo-Pointer-Creation"></a>
<div class="header">
<p>
Next: <a href="Menus.html#Menus" accesskey="n" rel="next">Menus</a>, Previous: <a href="Node-Menu-Illustration.html#Node-Menu-Illustration" accesskey="p" rel="prev">Node Menu Illustration</a>, Up: <a href="Nodes.html#Nodes" accesskey="u" rel="up">Nodes</a> &nbsp; [<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="makeinfo-Pointer-Creation-1"></a>
<h3 class="section">4.8 <code>makeinfo</code> Pointer Creation</h3>

<a name="index-Creating-pointers-with-makeinfo"></a>
<a name="index-Pointer-creation-with-makeinfo"></a>
<a name="index-Automatic-pointer-creation-with-makeinfo"></a>
<a name="index-Implicit-pointer-creation-with-makeinfo"></a>

<p>The <code>makeinfo</code> program can automatically determine node pointers
for a hierarchically organized document.  This implicit node pointer
creation feature in <code>makeinfo</code> relieves you from the need to
update menus and pointers manually or with Texinfo mode commands.
(See <a href="Updating-Nodes-and-Menus.html#Updating-Nodes-and-Menus">Updating Nodes and Menus</a>.)  We highly recommend taking
advantage of this.
</p>
<p>To do so, write your <code>@node</code> lines with just the name of the
node:
</p>
<div class="example">
<pre class="example">@node My Node
</pre></div>

<p>You do not need to write out the &lsquo;Next&rsquo;, &lsquo;Previous&rsquo;, and &lsquo;Up&rsquo;
pointers.
</p>
<p>Then, you must write a sectioning command, such as <code>@chapter</code>
or <code>@section</code>, on the line immediately following each truncated
<code>@node</code> line (except that comment lines may intervene).  This is
where it normally goes.
</p>
<p>Also, you must write the name of each node (except for the &lsquo;Top&rsquo; node)
in a menu that is one or more hierarchical levels above the node&rsquo;s
level.
</p>
<p>Finally, you must follow the &lsquo;Top&rsquo; <code>@node</code> line with a line
beginning with <code>@top</code> to mark the top-level node in the file.
See <a href="_0040top-Command.html#g_t_0040top-Command"><code>@top</code> Command</a>.
</p>
<a name="index-Detail-menu"></a>
<a name="index-detailmenu-1"></a>
<p>If you use a detailed menu in your master menu (see <a href="Master-Menu-Parts.html#Master-Menu-Parts">Master Menu Parts</a>), mark it with the <code>@detailmenu &hellip; @end
detailmenu</code> environment, or <code>makeinfo</code> will get confused,
typically about the last and/or first node in the document.
</p>
<p>In most cases, you will want to take advantage of this feature and not
redundantly specify node pointers that the programs can determine.
However, Texinfo documents are not required to be organized
hierarchically or in fact to contain sectioning commands at all (for
example, if you never intend the document to be printed), so node
pointers may still be specified explicitly, in full generality.
</p>

<hr>
<div class="header">
<p>
Next: <a href="Menus.html#Menus" accesskey="n" rel="next">Menus</a>, Previous: <a href="Node-Menu-Illustration.html#Node-Menu-Illustration" accesskey="p" rel="prev">Node Menu Illustration</a>, Up: <a href="Nodes.html#Nodes" accesskey="u" rel="up">Nodes</a> &nbsp; [<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>

APT Browse - Built by Thomas Orozco.