]> git.eshelyaron.com Git - emacs.git/commitdiff
; Eldoc: fix doc of e-d-functions w.r.t. :origin keyword
authorJoão Távora <joaotavora@gmail.com>
Sun, 2 Apr 2023 22:38:37 +0000 (23:38 +0100)
committerJoão Távora <joaotavora@gmail.com>
Sun, 2 Apr 2023 22:40:46 +0000 (23:40 +0100)
* lisp/emacs-lisp/eldoc.el (eldoc-documentation-functions): Fix.

lisp/emacs-lisp/eldoc.el

index ef4cda4650fd36af50789bd05cddb86b93919d34..8b427d6a825d79509115f85dcf3ac268afd587c9 100644 (file)
@@ -448,17 +448,17 @@ documentation-displaying frontends.  For example, KEY can be:
   `eldoc-display-in-echo-area' and `eldoc-display-in-buffer' will
   use when displaying `:thing''s value.
 
-* `:origin', VALUE being the member of
-  `eldoc-documentation-functions' where DOCSTRING
-  originated. `eldoc-display-in-buffer' may use this organize the
-  documentation buffer accordingly.
-
 * `:echo', controlling how `eldoc-display-in-echo-area' should
   present this documentation item in the echo area, to save
   space.  If VALUE is a string, echo it instead of DOCSTRING.  If
   a number, only echo DOCSTRING up to that character position.
   If `skip', don't echo DOCSTRING at all.
 
+The additional KEY `:origin' is always added by ElDoc, its VALUE
+being the member of `eldoc-documentation-functions' where
+DOCSTRING originated. `eldoc-display-functions' may use this
+information to organize display of multiple docstrings.
+
 Finally, major modes should modify this hook locally, for
 example:
   (add-hook \\='eldoc-documentation-functions #\\='foo-mode-eldoc nil t)