[elpa] externals/ivy-hydra 68ce6e6 384/395: Mention caveats for non-exiting commands in manual

[Basil L. Contovounesios]

branch: externals/ivy-hydra
commit 68ce6e6517b20c37d5abab1f511b1aae81534ddb
Author: Basil L. Contovounesios <contovob@tcd.ie>
Commit: Basil L. Contovounesios <contovob@tcd.ie>

    Mention caveats for non-exiting commands in manual
    
    * doc/ivy.org (Key bindings for multiple selections and actions keep
    minibuffer open): Mention that non-exiting commands only work with
    ivy-read.
    * doc/ivy.texi: Regenerate.
    
    Fixes #2798.
---
 doc/ivy.org  |  6 +++++-
 doc/ivy.texi | 13 +++++++++----
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/doc/ivy.org b/doc/ivy.org
index f9988c3..8b6d83b 100644
--- a/doc/ivy.org
+++ b/doc/ivy.org
@@ -405,13 +405,17 @@ extends usability of lists in Emacs.
 :END:
 
 For repeatedly applying multiple actions or acting on multiple
-candidates, Ivy does not close the minibuffer between commands. It
+candidates, Ivy does not close the minibuffer between commands.  It
 keeps the minibuffer open for applying subsequent actions.
 
 Adding an extra meta key to the normal key chord invokes the special
 version of the regular commands that enables applying multiple
 actions.
 
+Note that these operations are supported only by completion sessions
+that use the =ivy-read= API, rather than the built-in
+=completing-read=.
+
 - ~C-M-m~ (=ivy-call=) ::
      Is the non-exiting version of ~C-m~ (=ivy-done=).
 
diff --git a/doc/ivy.texi b/doc/ivy.texi
index 7beabff..be7775d 100644
--- a/doc/ivy.texi
+++ b/doc/ivy.texi
@@ -29,6 +29,7 @@ or any later version published by the Free Software 
Foundation;
 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
 A copy of the license is included in the section entitled "GNU
 Free Documentation License".
+
 @end quotation
 @end copying
 
@@ -217,7 +218,7 @@ version that runs Ivy with fancy faces display.
 @kbd{M-x} @code{package-install} @kbd{RET} @code{counsel} @kbd{RET}
 
 Ivy is installed as part of the @code{counsel} package, which is available
-from two different package archives, GNU ELPA and MELPA.  For the
+from two different package archives, GNU ELPA and MELPA@.  For the
 latest stable version, use the GNU ELPA archives.  For current hourly
 builds, use the MELPA archives.
 
@@ -516,13 +517,17 @@ keystrokes followed by @kbd{C-m}.
 @subsection Key bindings for multiple selections and actions, keep minibuffer 
open
 
 For repeatedly applying multiple actions or acting on multiple
-candidates, Ivy does not close the minibuffer between commands. It
+candidates, Ivy does not close the minibuffer between commands.  It
 keeps the minibuffer open for applying subsequent actions.
 
 Adding an extra meta key to the normal key chord invokes the special
 version of the regular commands that enables applying multiple
 actions.
 
+Note that these operations are supported only by completion sessions
+that use the @code{ivy-read} API, rather than the built-in
+@code{completing-read}.
+
 @subsubheading @kbd{C-M-m} (@code{ivy-call})
 @vindex ivy-call
 @kindex C-M-m
@@ -1811,12 +1816,12 @@ then retrieves that value and displays it.
 @end itemize
 
 @node Variable Index
-@unnumbered Variable Index
+@chapter Variable Index
 
 @printindex vr
 
 @node Keystroke Index
-@unnumbered Keystroke Index
+@chapter Keystroke Index
 
 @printindex ky