File Manager

Editing File: /usr/share/doc/info/html/Searching-Commands.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for Stand-alone GNU Info (version 6.7,
23 September 2019), 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. -->

<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Searching Commands (Stand-alone GNU Info 6.7)</title>

</head>

<body lang="en">
<div class="header">

Next: <a href="Index-Commands.html" accesskey="n" rel="next">Index Commands</a>, Previous: <a href="Node-Commands.html" accesskey="p" rel="prev">Node Commands</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]
</div>
<hr>
<h2 class="chapter">6 Searching an Info File</h2>

GNU Info allows you to search for a sequence of characters throughout an
entire Info file. Here are the commands to do this:

<dl compact="compact">
<dt><kbd>s</kbd> (<code>search</code>)</dt>
<dt><kbd>/</kbd></dt>
<dd>



Read a string in the echo area and search for it, either as a regular
expression (by default) or a literal string. If the string includes
upper-case characters, the Info file is searched case-sensitively;
otherwise Info ignores the letter case. With a numeric argument of
<var>N</var>, search for <var>N</var>th occurrence of the string. Negative
arguments search backwards.

</dd>
<dt><kbd>?</kbd> (<code>search-backward</code>)</dt>
<dd>

Read a string in the echo area and search backward through the Info file
for that string. If the string includes upper-case characters, the Info
file is searched case-sensitively; otherwise Info ignores the letter
case. With a numeric argument of <var>N</var>, search for <var>N</var>th
occurrence of the string. Negative arguments search forward.

</dd>
<dt><kbd>C-x <kbd>n</kbd></kbd> (<code>search-next</code>)</dt>
<dt><kbd>}</kbd></dt>
<dd>



Search forwards for the string used for the last search command.
Case sensitivity and use of regular expressions are kept the same. With
a numeric argument of <var>n</var>, search for <var>n</var>th next occurrence.

By default, the search starts at the position immediately following
the cursor. However, if the variable <code>search-skip-screen</code>
(see <a href="Variables.html"><code>search-skip-screen</code></a>) is set, it starts at
the beginning of the next page, thereby skipping all visibly displayed
lines.

</dd>
<dt><kbd>C-x <kbd>N</kbd></kbd> (<code>search-previous</code>)</dt>
<dt><kbd>{</kbd></dt>
<dd>


Just like <code>search-next</code>, but in reverse. You can use
<code>search-next</code> and <code>search-previous</code> together to move forward
and backward through matches. <code>search-previous</code> usually goes to
the place in the file that was displayed before an immediately preceding
<code>search-next</code>, and vice versa.<a id="DOCF3" href="#FOOT3">3</a>

</dd>
<dt><kbd>R</kbd> (<code>toggle-regexp</code>)</dt>
<dd>

Toggle between using regular expressions and literal strings for
searching. Info uses so-called &lsquo;extended&rsquo; regular expression syntax
(see <a href="../grep/Regular-Expressions.html#Regular-Expressions">Regular Expressions</a> in <cite>GNU Grep</cite>).

</dd>
<dt><kbd>S</kbd> (<code>search-case-sensitively</code>)</dt>
<dd>



Read a string in the echo area and search for it case-sensitively, even
if the string includes only lower-case letters. With a numeric argument
of <var>N</var>, search for <var>N</var>th occurrence of the string. Negative
arguments search backwards.

</dd>
<dt><kbd>C-s</kbd> (<code>isearch-forward</code>)</dt>
<dd>


Interactively search forward through the Info file for a string as you
type it. If the string includes upper-case characters, the search is
case-sensitive; otherwise Info ignores the letter case.

</dd>
<dt><kbd>C-r</kbd> (<code>isearch-backward</code>)</dt>
<dd>

Interactively search backward through the Info file for a string as
you type it. If the string includes upper-case characters, the search
is case-sensitive; otherwise Info ignores the letter case.

</dd>
<dt><kbd>M-/</kbd> (<code>tree-search</code>)</dt>
<dd>
Recursively search this node and any subnodes listed in menus for a 
string.

</dd>
<dt><kbd>M-}</kbd> (<code>tree-search-next</code>)</dt>
<dt><kbd>M-{</kbd> (<code>tree-search-previous</code>)</dt>
<dd>

Go forwards and backwards through the matches for an active tree search.
</dd>
</dl>

The most basic searching command is &lsquo;<samp>s</samp>&rsquo; or &lsquo;<samp>/</samp>&rsquo;
(<code>search</code>). The &lsquo;<samp>s</samp>&rsquo; command prompts you for a string in the
echo area, and then searches the remainder of the Info file for an
occurrence of that string. If the string is found, the node containing
it is selected, and the cursor is left positioned at the start of the
found string. Subsequent &lsquo;<samp>s</samp>&rsquo; commands show you the default search
string; pressing <tt class="key">RET</tt> instead of typing a new string will use the
default search string.

Incremental searching is similar to basic searching, but the
string is looked up while you are typing it, instead of waiting until
the entire search string has been specified.

The tree search can be used from the <code>dir</code> node to search through
all Info files installed on the system. It can also be used to search 
through a particular chapter of a manual when you are not interested in
matches in other chapters.



If the <code>highlight-searches</code> variable is set, matches from search
commands will be highlighted. See <a href="Variables.html"><code>highlight-searches</code></a>.
Use the <kbd>M-x clear-search</kbd> command to clear any search highlights.



Both incremental and non-incremental search by default ignore the case
of letters when comparing the Info file text with the search string.
However, an uppercase letter in the search string makes the search
case-sensitive. You can force a case-sensitive non-incremental search,
even for a string that includes only lower-case letters, by using the
&lsquo;<samp>S</samp>&rsquo; command (<code>search-case-sensitively</code>). The &lsquo;<samp>n</samp>&rsquo; and
&lsquo;<samp>N</samp>&rsquo; commands operate case-sensitively if the last search command
was &lsquo;<samp>S</samp>&rsquo;.

Normally, the search pattern should not be shorter than some
predefined limit. By default, this limit is set to 1 character.
See <a href="Variables.html#min_002dsearch_002dlength">min-search-length</a> for more information on this.

<div class="footnote">
<hr>
<h4 class="footnotes-heading">Footnotes</h4>

<h5><a id="FOOT3" href="#DOCF3">(3)</a></h3>
This sometimes doesn&rsquo;t
happen when <code>search-skip-screen</code> is <code>On</code>, and the search goes
across nodes.
</div>
<hr>
<div class="header">

Next: <a href="Index-Commands.html" accesskey="n" rel="next">Index Commands</a>, Previous: <a href="Node-Commands.html" accesskey="p" rel="prev">Node Commands</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]
</div>

</body>
</html>

Back to Directory File Manager