procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of 'occur'

Browse source 
* doc/emacs/search.texi (Other Repeating Search): Clarify how to
use Occur with search strings from last Isearch.  (Bug#24890)
This commit is contained in:
Eli Zaretskii 2016-11-10 18:25:21 +02:00
parent eb364fddec
commit 78aece497c
1 changed files with 13 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
doc/emacs/search.texi
View file

@ -1714,15 +1714,21 @@ a multi-file incremental search is activated automatically.
@cindex mode, Occur @cindex mode, Occur
@cindex match (face name) @cindex match (face name)
@vindex list-matching-lines-default-context-lines @vindex list-matching-lines-default-context-lines
@kindex M-s o
@item M-x occur @item M-x occur
@itemx M-s o
Prompt for a regexp, and display a list showing each line in the Prompt for a regexp, and display a list showing each line in the
buffer that contains a match for it. The text that matched is buffer that contains a match for it. If you type @kbd{M-n} at the
highlighted using the @code{match} face. To limit the search to part prompt, you can reuse search strings from previous incremental
of the buffer, narrow to that part (@pxref{Narrowing}). A numeric searches. The text that matched is highlighted using the @code{match}
argument @var{n} specifies that @var{n} lines of context are to be face. To limit the search to part of the buffer, narrow to that part
displayed before and after each matching line. The default number of (@pxref{Narrowing}). A numeric argument @var{n} specifies that
context lines is specified by the variable @var{n} lines of context are to be displayed before and after each
@code{list-matching-lines-default-context-lines}. matching line. The default number of context lines is specified by
the variable @code{list-matching-lines-default-context-lines}.
You can also run @kbd{M-s o} when an incremental search is active;
this uses the current search string.
@kindex RET @r{(Occur mode)} @kindex RET @r{(Occur mode)}
@kindex o @r{(Occur mode)} @kindex o @r{(Occur mode)}
@ -1744,12 +1750,6 @@ mode.
The command @kbd{M-x list-matching-lines} is a synonym for @kbd{M-x The command @kbd{M-x list-matching-lines} is a synonym for @kbd{M-x
occur}. occur}.
@kindex M-s o
@item M-s o
Run @code{occur} using the search string of the last incremental
string search. You can also run @kbd{M-s o} when an incremental
search is active; this uses the current search string.
@item M-x multi-occur @item M-x multi-occur
This command is just like @code{occur}, except it is able to search This command is just like @code{occur}, except it is able to search
through multiple buffers. It asks you to specify the buffer names one through multiple buffers. It asks you to specify the buffer names one