; Better clarify function types in C-h f (bug#73626)
authorAndrea Corallo <acorallo@gnu.org>
Thu, 14 Nov 2024 00:01:08 +0000 (01:01 +0100)
committerAndrea Corallo <acorallo@gnu.org>
Thu, 21 Nov 2024 14:39:27 +0000 (15:39 +0100)
* doc/emacs/help.texi (Name Help): Better clarify function types.

doc/emacs/help.texi

index f15b4c5e89dc6a2aa11cfbf40b62624ccc7b341c..079ea76156f83769c83c2add5f850c6d85a9dc08 100644 (file)
@@ -322,6 +322,15 @@ 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.
 
+@cindex function type specifier
+
+The function type, if known, is expressed with a @dfn{function type
+specifier} (@pxref{Type Specifiers,,,elisp, The Emacs Lisp Reference
+Manual}), it will be specified if the type was manually declared by the
+programmer or inferred by the compiler.  Note that function type
+inference works only when native compilation is enabled (@pxref{native
+compilation,,, elisp, The Emacs Lisp Reference Manual}).
+
 @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})