[Emacs-diffs] master d05410f: Improve documentation of COLLECTION in completion functions

[Eli Zaretskii]

branch: master
commit d05410f349661768845a8c16a9d473b175d6a1de
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve documentation of COLLECTION in completion functions
    
    * doc/lispref/minibuf.texi (Minibuffer Completion): Add a
    cross-reference to "Programmed Completion".
    
    * src/minibuf.c (Fcompleting_read): Improve the doc string.
    (Bug#21644)
---
 doc/lispref/minibuf.texi |    3 +++
 src/minibuf.c            |    7 +++++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index 96c1020..0b1a4a9 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -975,6 +975,9 @@ Thus, if @var{predicate} is address@hidden, it should be 
compatible
 with @var{collection} and @code{completion-ignore-case}.
 @xref{Definition of test-completion}.
 
address@hidden Completion}, for detailed requirements when
address@hidden is a function.
+
 The value of the optional argument @var{require-match} determines how
 the user may exit the minibuffer:
 
diff --git a/src/minibuf.c b/src/minibuf.c
index 2cde8b0..e149e81 100644
--- a/src/minibuf.c
+++ b/src/minibuf.c
@@ -1595,8 +1595,11 @@ PROMPT is a string to prompt with; normally it ends in a 
colon and a space.
 COLLECTION can be a list of strings, an alist, an obarray or a hash table.
 COLLECTION can also be a function to do the completion itself.
 PREDICATE limits completion to a subset of COLLECTION.
-See Info node `(elisp)Basic Completion' for more details
- on completion, COLLECTION, and PREDICATE.
+See `try-completion', `all-completions', `test-completion',
+and `completion-boundaries', for more details on completion,
+COLLECTION, and PREDICATE.  See also Info nodes `(elisp)Basic Completion'
+for the details about completion, and `(elisp)Programmed Completion' for
+expectations from COLLECTION when it's a function.
 
 REQUIRE-MATCH can take the following values:
 - t means that the user is not allowed to exit unless