From: Stefan Monnier <monnier@iro.umontreal.ca>
Date: Sun, 24 Mar 2024 02:27:34 +0000 (-0400)
Subject: * doc/emacs/help.texi (Name Help): Mention buttons (bug#69935)
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a71ac138f9d3be62cc42b0fe661afe2f6b73f889;p=emacs.git

* doc/emacs/help.texi (Name Help): Mention buttons (bug#69935)

(cherry picked from commit 044558766a77b1c9b8a7e6d757ca65730a88b88d)
---

diff --git a/doc/emacs/help.texi b/doc/emacs/help.texi
index 7e213018003..c799e8d55ca 100644
--- a/doc/emacs/help.texi
+++ b/doc/emacs/help.texi
@@ -305,6 +305,13 @@ name is defined as a Lisp function.  Type @kbd{C-g} to cancel the
 @kbd{C-h f} command if you don't really want to view the
 documentation.
 
+  The function's documentation displayed by @code{describe-function}
+includes more than just the documentation string and the signature of
+the function.  It also shows auxiliary information such as its type, the
+file where it was defined, whether it has been declared obsolete, and
+yet further information is often reachable by clicking or typing
+@key{RET} on emphasized parts of the text.
+
 @vindex help-enable-symbol-autoload
   If you request help for an autoloaded function whose @code{autoload}
 form (@pxref{Autoload,,, elisp, The Emacs Lisp Reference Manual})