[Emacs-diffs] emacs-26 82b6c76: Improve indexing of multi-file/buffer Isearch commands

[Eli Zaretskii]

branch: emacs-26
commit 82b6c765ffa18f4e3892b860eb77a9ea24430bbb
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve indexing of multi-file/buffer Isearch commands
    
    * doc/emacs/maintaining.texi (Identifier Search): Change wording
    of index entries to make them different from those for multi-file
    isearch commands.  (Bug#28584)
    * doc/emacs/search.texi (Other Repeating Search): Index the
    multi-* commands.  (Bug#28584)  Rearrange the indexing to keep
    each index entry close to its subject.
---
 doc/emacs/maintaining.texi |  4 ++--
 doc/emacs/search.texi      | 23 +++++++++++++++--------
 2 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 39b7144..7f91991 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -1918,8 +1918,8 @@ without displaying the references.
 
 @node Identifier Search
 @subsubsection Searching and Replacing with Identifiers
address@hidden search and replace in multiple files
address@hidden multiple-file search and replace
address@hidden search and replace in multiple source files
address@hidden multiple source file search and replace
 
   The commands in this section perform various search and replace
 operations either on identifiers themselves or on files that reference
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index 9f7e9a1..63cc1c2 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -1685,15 +1685,10 @@ Aside from @code{multi-occur} and 
@code{multi-occur-in-matching-buffers},
 which always search the whole buffer, all operate on the text from point
 to the end of the buffer, or on the region if it is active.
 
address@hidden list-matching-lines
address@hidden occur
address@hidden multi-occur
address@hidden multi-occur-in-matching-buffers
address@hidden how-many
address@hidden flush-lines
address@hidden keep-lines
-
 @table @kbd
address@hidden multi-isearch-buffers
address@hidden isearch multiple buffers
address@hidden multiple-buffer isearch
 @item M-x multi-isearch-buffers
 Prompt for one or more buffer names, ending with @key{RET}; then,
 begin a multi-buffer incremental search in those buffers.  (If the
@@ -1702,10 +1697,14 @@ next specified buffer, and so forth.)  With a prefix 
argument, prompt
 for a regexp and begin a multi-buffer incremental search in buffers
 matching that regexp.
 
address@hidden multi-isearch-buffers-regexp
 @item M-x multi-isearch-buffers-regexp
 This command is just like @code{multi-isearch-buffers}, except it
 performs an incremental regexp search.
 
address@hidden multi-isearch-files
address@hidden isearch multiple files
address@hidden multiple-file isearch
 @item M-x multi-isearch-files
 Prompt for one or more file names, ending with @key{RET}; then,
 begin a multi-file incremental search in those files.  (If the
@@ -1714,6 +1713,7 @@ next specified file, and so forth.)  With a prefix 
argument, prompt
 for a regexp and begin a multi-file incremental search in files
 matching that regexp.
 
address@hidden multi-isearch-files-regexp
 @item M-x multi-isearch-files-regexp
 This command is just like @code{multi-isearch-files}, except it
 performs an incremental regexp search.
@@ -1729,6 +1729,7 @@ a multi-file incremental search is activated 
automatically.
 @vindex list-matching-lines-jump-to-current-line
 @cindex list-matching-lines-current-line-face (face name)
 @kindex M-s o
address@hidden occur
 @item M-x occur
 @itemx M-s o
 Prompt for a regexp, and display a list showing each line in the
@@ -1768,25 +1769,30 @@ mode, in which edits made to the entries are also 
applied to the text
 in the originating buffer.  Type @kbd{C-c C-c} to return to Occur
 mode.
 
address@hidden list-matching-lines
 The command @kbd{M-x list-matching-lines} is a synonym for @kbd{M-x
 occur}.
 
address@hidden multi-occur
 @item M-x multi-occur
 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
 by one.
 
address@hidden multi-occur-in-matching-buffers
 @item M-x multi-occur-in-matching-buffers
 This command is similar to @code{multi-occur}, except the buffers to
 search are specified by a regular expression that matches visited file
 names.  With a prefix argument, it uses the regular expression to
 match buffer names instead.
 
address@hidden how-many
 @item M-x how-many
 Prompt for a regexp, and print the number of matches for it in the
 buffer after point.  If the region is active, this operates on the
 region instead.
 
address@hidden flush-lines
 @item M-x flush-lines
 Prompt for a regexp, and delete each line that contains a match for
 it, operating on the text after point.  This command deletes the
@@ -1800,6 +1806,7 @@ lines.  It deletes the lines before starting to look for 
the next
 match; hence, it ignores a match starting on the same line at which
 another match ended.
 
address@hidden keep-lines
 @item M-x keep-lines
 Prompt for a regexp, and delete each line that @emph{does not} contain
 a match for it, operating on the text after point.  If point is not at