[Emacs-diffs] emacs-25 ebf0472: Add to elisp-completion-at-point's docstring

[Noam Postavsky]

branch: emacs-25
commit ebf047254b374eedc6fa24625d30213aa095cab9
Author: Noam Postavsky <address@hidden>
Commit: Noam Postavsky <address@hidden>

    Add to elisp-completion-at-point's docstring
    
    * lisp/progmodes/elisp-mode.el (elisp-completion-at-point): Document
    position dependent behavior (Bug #19854).
---
 lisp/progmodes/elisp-mode.el |    8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/lisp/progmodes/elisp-mode.el b/lisp/progmodes/elisp-mode.el
index 7ad8871..5111f88 100644
--- a/lisp/progmodes/elisp-mode.el
+++ b/lisp/progmodes/elisp-mode.el
@@ -455,7 +455,13 @@ It can be quoted, or be inside a quoted form."
      ((facep sym) (find-definition-noselect sym 'defface)))))
 
 (defun elisp-completion-at-point ()
-  "Function used for `completion-at-point-functions' in `emacs-lisp-mode'."
+  "Function used for `completion-at-point-functions' in `emacs-lisp-mode'.
+If the context at point allows only a certain category of
+symbols (e.g. functions, or variables) then the returned
+completions are restricted to that category.  In contexts where
+any symbol is possible (following a quote, for example),
+functions are annotated with \"<f>\" via the
+`:annotation-function' property."
   (with-syntax-table emacs-lisp-mode-syntax-table
     (let* ((pos (point))
           (beg (condition-case nil