/usr/share/doc/texinfo/html/Node-Names.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 | <!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>Node Names (GNU Texinfo 6.5)</title>
<meta name="description" content="Node Names (GNU Texinfo 6.5)">
<meta name="keywords" content="Node Names (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="Writing-a-Node.html#Writing-a-Node" rel="next" title="Writing a Node">
<link href="Texinfo-Document-Structure.html#Texinfo-Document-Structure" rel="prev" title="Texinfo Document Structure">
<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="Node-Names"></a>
<div class="header">
<p>
Next: <a href="Writing-a-Node.html#Writing-a-Node" accesskey="n" rel="next">Writing a Node</a>, Previous: <a href="Texinfo-Document-Structure.html#Texinfo-Document-Structure" accesskey="p" rel="prev">Texinfo Document Structure</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="Choosing-Node-Names"></a>
<h3 class="section">4.2 Choosing Node Names</h3>
<a name="index-Node-names_002c-choosing"></a>
<p>The name of a node identifies the node. For all the details of node
names, see <a href="Node-Line-Requirements.html#Node-Line-Requirements">Node Line Requirements</a>).
</p>
<a name="Node-Line-Tips"></a><p>Here are some suggestions for node names:
</p>
<ul>
<li> Try to pick node names that are informative but short.
<p>In the Info file, the file name, node name, and pointer names are all
inserted on one line, which may run into the right edge of the window.
(This does not cause a problem with Info, but is ugly.)
</p>
</li><li> Try to pick node names that differ from each other near the beginnings
of their names. This way, it is easy to use automatic name completion in
Info.
</li><li> Conventionally, node names are capitalized in the same way as section
and chapter titles. In this manual, initial and significant words are
capitalized; others are not. In other manuals, just initial words and
proper nouns are capitalized. Either way is fine; we recommend just
being consistent.
</li></ul>
<p>Because node names are used in cross-references, it is not desirable
to casually change them once published. Such name changes invalidate
references from other manuals, from mail archives, and so on.
See <a href="HTML-Xref-Link-Preservation.html#HTML-Xref-Link-Preservation">HTML Xref Link Preservation</a>.
</p>
<p>The pointers from a given node enable you to reach other nodes and
consist simply of the names of those nodes. The pointers are usually
not specified explicitly, as <code>makeinfo</code> can determine them
(see <a href="makeinfo-Pointer-Creation.html#makeinfo-Pointer-Creation"><code>makeinfo</code> Pointer Creation</a>).
</p>
<p>Normally, a node’s ‘Up’ pointer contains the name of the node whose
menu mentions that node. The node’s ‘Next’ pointer contains the name
of the node that follows the present node in that menu and its
‘Previous’ pointer contains the name of the node that precedes it in
that menu. When a node’s ‘Previous’ node is the same as its ‘Up’
node, both pointers name the same node.
</p>
<p>Usually, the first node of a Texinfo file is the ‘Top’ node, and its
‘Up’ pointer points to the <samp>dir</samp> file, which contains the main menu
for all of Info.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Writing-a-Node.html#Writing-a-Node" accesskey="n" rel="next">Writing a Node</a>, Previous: <a href="Texinfo-Document-Structure.html#Texinfo-Document-Structure" accesskey="p" rel="prev">Texinfo Document Structure</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>
|