masscollaborationlabs/emacs
2
0
Fork 0
mirror of https://github.com/masscollaborationlabs/emacs.git synced 2025-07-05 03:39:38 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Tweak doc w.r.t to "void function" (bug#73886)

Browse source 
* doc/lispref/functions.texi (Function Cells): Avoid talking
about the function cell being void.

* src/data.c (Fboundp, Ffmakunbound, Fsymbol_function):
Don't suggest that "void" can be considered as a kind of value.
This commit is contained in:
Stefan Monnier 2024-10-27 14:52:25 -04:00
parent 7a8ca202c5
commit 9e1abf11fc
2 changed files with 7 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

11
doc/lispref/functions.texi
View file

@ -1510,10 +1510,7 @@ indirect-function}.
@kindex void-function @kindex void-function
This returns the object in the function cell of @var{symbol}. It does This returns the object in the function cell of @var{symbol}. It does
not check that the returned object is a legitimate function. not check that the returned object is a legitimate function.
If the function is void, the return value is @code{nil}.
If the function cell is void, the return value is @code{nil}. It is
impossible to distinguish between a function cell that is void and one
set to @code{nil}.
@example @example
@group @group
@ -1533,9 +1530,9 @@ set to @code{nil}.
@end defun @end defun
@cindex void function cell @cindex void function cell
If you have never given a symbol any function definition, we say If you have never given a symbol any function definition, its function
that that symbol's function cell is @dfn{void}. In other words, the cell contains the default value @code{nil} and we say
function cell does not have any Lisp object in it. If you try to call that that function is @dfn{void}. If you try to call
the symbol as a function, Emacs signals a @code{void-function} error. the symbol as a function, Emacs signals a @code{void-function} error.
Unlike with void variables (@pxref{Void Variables}), a symbol's Unlike with void variables (@pxref{Void Variables}), a symbol's

6
src/data.c
View file

@ -756,7 +756,7 @@ global value outside of any lexical scope. */)
breaking backward compatibility, as some users of fboundp may breaking backward compatibility, as some users of fboundp may
expect t in particular, rather than any true value. */ expect t in particular, rather than any true value. */
DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0, DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
doc: /* Return t if SYMBOL's function definition is neither void nor nil. */) doc: /* Return t if SYMBOL's function definition is not nil. */)
(Lisp_Object symbol) (Lisp_Object symbol)
{ {
CHECK_SYMBOL (symbol); CHECK_SYMBOL (symbol);
@ -785,7 +785,7 @@ DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
doc: /* Make SYMBOL's function definition be nil. doc: /* Make SYMBOL's function definition be nil.
Return SYMBOL. Return SYMBOL.
If a function definition is nil or void, trying to call a function by If a function definition is nil, trying to call a function by
that name will cause a `void-function' error. For more details, see that name will cause a `void-function' error. For more details, see
Info node `(elisp) Function Cells'. Info node `(elisp) Function Cells'.
@ -800,7 +800,7 @@ See also `makunbound'. */)
} }
DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0, DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
doc: /* Return SYMBOL's function definition, or nil if that is void or nil. */) doc: /* Return SYMBOL's function definition. */)
(Lisp_Object symbol) (Lisp_Object symbol)
{ {
CHECK_SYMBOL (symbol); CHECK_SYMBOL (symbol);