texinfo-doc-nonfree 6.5.0-1 / usr / share / doc / texinfo / html / First-Node.html

This file is indexed.

/usr/share/doc/texinfo/html/First-Node.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
138
139
140
141
142
143
144
145
<!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>First Node (GNU Texinfo 6.5)</title>

<meta name="description" content="First Node (GNU Texinfo 6.5)">
<meta name="keywords" content="First Node (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="_0040top-Command.html#g_t_0040top-Command" rel="next" title="@top Command">
<link href="Node-Line-Requirements.html#Node-Line-Requirements" rel="prev" title="Node Line Requirements">
<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="First-Node"></a>
<div class="header">
<p>
Next: <a href="_0040top-Command.html#g_t_0040top-Command" accesskey="n" rel="next"><code>@top</code> Command</a>, Previous: <a href="Node-Line-Requirements.html#Node-Line-Requirements" accesskey="p" rel="prev">Node Line Requirements</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="The-First-Node"></a>
<h3 class="section">4.5 The First Node</h3>
<a name="index-Top-node-is-first"></a>
<a name="index-First-node"></a>

<p>The first node of a Texinfo file is the <em>Top</em> node, except in an
included file (see <a href="Include-Files.html#Include-Files">Include Files</a>).  The Top node should contain a
short summary, copying permissions, and a master menu.  See <a href="The-Top-Node.html#The-Top-Node">The Top Node</a>, for more information on the Top node contents and examples.
</p>
<p>Here is a description of the node pointers to be used in the Top node:
</p>
<ul>
<li> <a name="index-Up-node-of-Top-node"></a>
<a name="index-_0028dir_0029-as-Up-node-of-Top-node"></a>
The Top node (which must be named &lsquo;<samp>top</samp>&rsquo; or &lsquo;<samp>Top</samp>&rsquo;) should have
as its &lsquo;Up&rsquo; node the name of a node in another file, where there is a
menu that leads to this file.  Specify the file name in parentheses.

<p>Usually, all Info files are available through a single virtual Info
tree, constructed from multiple directories.  In this case, use
&lsquo;<samp>(dir)</samp>&rsquo; as the parent of the Top node; this specifies the
top-level node in the <samp>dir</samp> file, which contains the main menu
for the Info system as a whole.  (Each directory with Info files is
intended to contain a file named <samp>dir</samp>.)
</p>
<p>That&rsquo;s fine for Info, but for HTML output, one might well want the Up
link from the Top node to go somewhere other than &lsquo;<samp>dir.html</samp>&rsquo;.
For example, for GNU the natural place would be
<a href="http://www.gnu.org/manual/">http://www.gnu.org/manual/</a> (a web page collecting links to most
GNU manuals), better specified as just <code>/manual/</code> if the manual
will be installed on <code>www.gnu.org</code>.  This can be specified with
the <code>TOP_NODE_UP_URL</code> customization variable (see <a href="HTML-Customization-Variables.html#HTML-Customization-Variables">HTML Customization Variables</a>), as in
</p>
<div class="example">
<pre class="example">$ <kbd>makeinfo --html -c TOP_NODE_UP_URL=/manual/</kbd> ...
</pre></div>

<p>All links to <code>(dir)</code> will be replaced by the given url.
</p>
</li><li> <a name="index-Prev-node-of-Top-node"></a>
The &lsquo;Prev&rsquo; node of the Top node is usually either omitted or also set
to <samp>(dir)</samp>.  Either is fine.

</li><li> <a name="index-Next-node-of-Top-node"></a>
The &lsquo;Next&rsquo; node of the Top node should be the first chapter in your
document.

</li></ul>

<p>See <a href="Installing-an-Info-File.html#Installing-an-Info-File">Installing an Info File</a>, for more information about installing
an Info file in the <samp>info</samp> directory.
</p>
<p>It is usually best to leave the pointers off entirely and let the
tools implicitly define them, with this simple result:
</p>
<div class="example">
<pre class="example">@node Top
</pre></div>


<hr>
<div class="header">
<p>
Next: <a href="_0040top-Command.html#g_t_0040top-Command" accesskey="n" rel="next"><code>@top</code> Command</a>, Previous: <a href="Node-Line-Requirements.html#Node-Line-Requirements" accesskey="p" rel="prev">Node Line Requirements</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.