Current File : //usr/share/doc/info/html/Node-Commands.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual is for Stand-alone GNU Info (version 6.8,
22 November 2020), a program for viewing documents in Info format
(usually created from Texinfo source files).
Copyright (C) 1992, 1993, 1996, 1997, 1998, 1999, 2001,
2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012,
2013, 2014, 2015, 2016, 2017, 2018, 2019 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 no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
"GNU Free Documentation License" in the Texinfo manual.
This document is part of a collection distributed under the GNU Free
Documentation License. If you want to distribute this document
separately from the collection, you can do so by adding a copy of the
license to the document, as described in section 6 of the license. -->
<title>Node Commands (Stand-alone GNU Info 6.8)</title>
<meta name="description" content="Node Commands (Stand-alone GNU Info 6.8)">
<meta name="keywords" content="Node Commands (Stand-alone GNU Info 6.8)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="Searching-Commands.html" rel="next" title="Searching Commands">
<link href="Scrolling-Commands.html" rel="prev" title="Scrolling Commands">
<style type="text/css">
<!--
a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em}
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {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}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
span:hover a.copiable-anchor {visibility: visible}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<div class="chapter" id="Node-Commands">
<div class="header">
<p>
Next: <a href="Searching-Commands.html" accesskey="n" rel="next">Searching an Info File</a>, Previous: <a href="Scrolling-Commands.html" accesskey="p" rel="prev">Moving Text Within a Window</a>, Up: <a href="index.html" accesskey="u" rel="up">Stand-alone GNU Info</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Selecting-a-Node"></span><h2 class="chapter">5 Selecting a Node</h2>
<span id="index-nodes_002c-selection-of"></span>
<p>This section details the numerous Info commands which select a new node
to view in the current window.
</p>
<p>The most basic node commands are ‘<samp>n</samp>’, ‘<samp>p</samp>’, ‘<samp>u</samp>’, and
‘<samp>l</samp>’.
</p>
<p>When you are viewing a node, the top line of the node contains some Info
<em>pointers</em> which describe where the next, previous, and up nodes
are. Info uses this line to move about the node structure of the file
when you use the following commands:
</p>
<dl compact="compact">
<dt id='index-n'><span><kbd>n</kbd> (<code>next-node</code>)<a href='#index-n' class='copiable-anchor'> ¶</a></span></dt>
<dt><span><kbd>C-<span class="key">NEXT</span></kbd> (on DOS/Windows only)</span></dt>
<dd><span id="index-C_002dNEXT"></span>
<span id="index-next_002dnode"></span>
<p>Select the ‘Next’ node.
</p>
<span id="index-C_002dPgDn"></span>
<p>The <tt class="key">NEXT</tt> key is known as the <tt class="key">PgDn</tt> key on some
keyboards.
</p>
</dd>
<dt id='index-p'><span><kbd>p</kbd> (<code>prev-node</code>)<a href='#index-p' class='copiable-anchor'> ¶</a></span></dt>
<dt><span><kbd>C-<span class="key">PREVIOUS</span></kbd> (on DOS/Windows only)</span></dt>
<dd><span id="index-C_002dPREVIOUS"></span>
<span id="index-prev_002dnode"></span>
<p>Select the ‘Prev’ node.
</p>
<span id="index-C_002dPgUp"></span>
<p>The <tt class="key">PREVIOUS</tt> key is known as the <tt class="key">PgUp</tt> key on some
keyboards.
</p>
</dd>
<dt id='index-u'><span><kbd>u</kbd> (<code>up-node</code>)<a href='#index-u' class='copiable-anchor'> ¶</a></span></dt>
<dt><span><kbd>C-<span class="key">UP</span></kbd> (an arrow key on DOS/Windows only)</span></dt>
<dd><span id="index-C_002dUP"></span>
<span id="index-up_002dnode"></span>
<p>Select the ‘Up’ node.
</p></dd>
</dl>
<p>You can easily select a node that you have already viewed in this window
by using the ‘<samp>l</samp>’ command—this name stands for “last”, and
actually moves backwards through the history of visited nodes for this
window. This is handy when you followed a reference to another node,
possibly to read about a related issue, and would like then to resume
reading at the same place where you started the excursion.
</p>
<p>Each node where you press ‘<samp>l</samp>’ is discarded from the history. Thus,
by the time you get to the first node you visited in a window, the
entire history of that window is discarded.
</p>
<dl compact="compact">
<dt id='index-l'><span><kbd>l</kbd> (<code>history-node</code>)<a href='#index-l' class='copiable-anchor'> ¶</a></span></dt>
<dt><span><kbd>C-<span class="key">CENTER</span></kbd> (on DOS/Windows only)</span></dt>
<dd><span id="index-C_002dCENTER"></span>
<span id="index-history_002dnode"></span>
<p>Pop the most recently selected node in this window from the node
history.
</p></dd>
</dl>
<p>Two additional commands make it easy to select the most commonly
selected nodes; they are ‘<samp>t</samp>’ and ‘<samp>d</samp>’.
</p>
<dl compact="compact">
<dt id='index-t'><span><kbd>t</kbd> (<code>top-node</code>)<a href='#index-t' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-top_002dnode"></span>
<p>Select the node ‘<samp>Top</samp>’ in the current Info file.
</p>
</dd>
<dt id='index-d'><span><kbd>d</kbd> (<code>dir-node</code>)<a href='#index-d' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-dir_002dnode"></span>
<p>Select the directory node (i.e., the node ‘<samp>(dir)</samp>’).
</p></dd>
</dl>
<p>Here are some other commands which immediately result in the selection
of a different node in the current window:
</p>
<dl compact="compact">
<dt id='index-_003c'><span><kbd><</kbd> (<code>first-node</code>)<a href='#index-_003c' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-first_002dnode"></span>
<p>Selects the first node which appears in this file. This node is most
often ‘<samp>Top</samp>’, but it does not have to be. With a numeric argument
<var>N</var>, select the <var>N</var>th node (the first node is node 1). An
argument of zero is the same as the argument of 1.
</p>
</dd>
<dt id='index-_003e'><span><kbd>></kbd> (<code>last-node</code>)<a href='#index-_003e' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-last_002dnode"></span>
<p>Select the last node which appears in this file. With a numeric argument
<var>N</var>, select the <var>N</var>th node (the first node is node 1). An
argument of zero is the same as no argument, i.e., it selects the last
node.
</p>
</dd>
<dt id='index-_005d'><span><kbd>]</kbd> (<code>global-next-node</code>)<a href='#index-_005d' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-global_002dnext_002dnode"></span>
<p>Move forward through the node structure. If the node that you are
currently viewing has a menu, select the first menu item. Otherwise,
if this node has a ‘<samp>Next</samp>’ pointer, follow it. If there is no menu
and no ‘<samp>Next</samp>’ pointer, then follow ‘<samp>Up</samp>’ pointers until there
is a ‘<samp>Next</samp>’ pointer, and then follow it.
</p>
</dd>
<dt id='index-_005b'><span><kbd>[</kbd> (<code>global-prev-node</code>)<a href='#index-_005b' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-global_002dprev_002dnode"></span>
<p>Move backward through the node structure. If the node that you are
currently viewing has a ‘<samp>Prev</samp>’ pointer, that node is selected.
Otherwise, if the node has an ‘<samp>Up</samp>’ pointer, that node is selected,
and if it has a menu, the last item in the menu is selected.
</p></dd>
</dl>
<p>You can get the same behavior as <code>global-next-node</code> and
<code>global-prev-node</code> while simply scrolling through the file with
<tt class="key">SPC</tt> and <tt class="key">DEL</tt> (see <a href="Variables.html#scroll_002dbehavior">scroll-behavior</a>).
</p>
<dl compact="compact">
<dd><span id="goto_002dnode"></span></dd>
<dt id='index-g'><span><kbd>g</kbd> (<code>goto-node</code>)<a href='#index-g' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-goto_002dnode"></span>
<p>Read the name of a node and select it. If the desired node resides in
some other file, you must type the node as it appears in that Info file,
and include the name of the other file. For example,
</p>
<div class="example">
<pre class="example"><code>g(emacs)Buffers</code>
</pre></div>
<p>finds the node ‘<samp>Buffers</samp>’ in the Info file <samp>emacs</samp>.
</p>
<p>While reading the node name, completion (see <a href="The-Echo-Area.html">completion</a>) is only done for the nodes which reside in one of the Info
files that were loaded in the current Info session.
</p>
<span id="goto_002dinvocation"></span></dd>
<dt id='index-O'><span><kbd>O</kbd> (<code>goto-invocation</code>)<a href='#index-O' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-goto_002dinvocation"></span>
<span id="index-finding-the-Invocation-node"></span>
<p>Read the name of a program and look for a node in the current Info file
which describes the invocation and the command-line options for that
program. The default program name is derived from the name of the
current Info file. This command does the same as the
‘<samp>--show-options</samp>’ command-line option (see <a href="Invoking-Info.html#g_t_002d_002dshow_002doptions">--show-options</a>), but
it also allows to specify the program name; this is important for those
manuals which describe several programs.
</p>
<p>If you need to find the Invocation node of a program that is documented
in another Info file, you need to visit that file before invoking
‘<samp>O</samp>’. For example, if you are reading the Emacs manual and want to
see the command-line options of the <code>makeinfo</code> program, type <kbd>g
(texinfo) <span class="key">RET</span></kbd> and then <kbd>I makeinfo <span class="key">RET</span></kbd>. If you don’t
know what Info file documents the command, or if invoking ‘<samp>O</samp>’
doesn’t display the right node, go to the ‘<samp>(dir)</samp>’ node (using the
‘<samp>d</samp>’ command) and invoke ‘<samp>O</samp>’ from there.
</p>
</dd>
<dt id='index-G'><span><kbd>G</kbd> (<code>menu-sequence</code>)<a href='#index-G' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-menu_002dsequence"></span>
<span id="index-menu_002c-following_002c-from-inside-Info"></span>
<p>Read a sequence of menu entries and follow it. Info prompts for a
sequence of menu items separated by commas. (Since commas are not
allowed in a node name, they are a natural choice for a delimiter in a
list of menu items.) Info then looks up the first item in the menu of
the node ‘<samp>(dir)</samp>’ (if the ‘<samp>(dir)</samp>’ node cannot be found, Info
uses ‘<samp>Top</samp>’). If such an entry is found, Info goes to the node it
points to and looks up the second item in the menu of that node, etc.
In other words, you can specify a complete path which descends through
the menu hierarchy of a particular Info file starting at the
‘<samp>(dir)</samp>’ node. This has the same effect as if you typed the menu
item sequence on Info’s command line, see <a href="Invoking-Info.html#command_002dline-menu-items">Info command-line arguments processing</a>. For example,
</p>
<div class="example">
<pre class="example"> <kbd>G Texinfo,Overview,Reporting Bugs <span class="key">RET</span></kbd>
</pre></div>
<p>displays the node ‘<samp>Reporting Bugs</samp>’ in the Texinfo manual. (You
don’t actually need to type the menu items in their full length, or in
their exact letter-case. However, if you do type the menu items
exactly, Info will find it faster.)
</p>
<p>If any of the menu items you type are not found, Info stops at the last
entry it did find and reports an error.
</p>
</dd>
<dt id='index-C_002dx-C_002df'><span><kbd>C-x C-f</kbd> (<code>view-file</code>)<a href='#index-C_002dx-C_002df' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-view_002dfile"></span>
<p>Read the name of a file and selects the entire file. The command
</p><div class="example">
<pre class="example"><code>C-x C-f <var>filename</var></code>
</pre></div>
<p>is equivalent to typing
</p><div class="example">
<pre class="example"><code>g(<var>filename</var>)*</code>
</pre></div>
</dd>
<dt id='index-C_002dx-C_002db'><span><kbd>C-x C-b</kbd> (<code>list-visited-nodes</code>)<a href='#index-C_002dx-C_002db' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-list_002dvisited_002dnodes"></span>
<p>Make a window containing a menu of all of the currently visited nodes.
This window becomes the selected window, and you may use the standard
Info commands within it.
</p>
</dd>
<dt id='index-C_002dx-b'><span><kbd>C-x <kbd>b</kbd></kbd> (<code>select-visited-node</code>)<a href='#index-C_002dx-b' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-select_002dvisited_002dnode"></span>
<p>Select a node which has been previously visited in a visible window.
This is similar to ‘<samp>C-x C-b</samp>’ followed by ‘<samp>m</samp>’, but no window is
created.
</p>
</dd>
<dt id='index-man'><span><code>M-x man</code><a href='#index-man' class='copiable-anchor'> ¶</a></span></dt>
<dd><span id="index-man-pages_002c-displaying"></span>
<p>Read the name of a man page to load and display. This uses the <code>man</code>
command on your system to retrieve the contents of the requested man page.
See also see <a href="Invoking-Info.html#g_t_002d_002draw_002descapes">--raw-escapes</a>.
</p>
</dd>
</dl>
</div>
<hr>
<div class="header">
<p>
Next: <a href="Searching-Commands.html">Searching an Info File</a>, Previous: <a href="Scrolling-Commands.html">Moving Text Within a Window</a>, Up: <a href="index.html">Stand-alone GNU Info</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
Mini Shell