procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document that quoting yields constants

Browse source 
* doc/lispref/eval.texi (Quoting, Backquote):
Mention that quoted expressions yield a constant (Bug#40693).
This commit is contained in:
Paul Eggert 2020-04-19 09:37:51 -07:00
parent 5734339f40
commit 81e7d7f111
1 changed files with 7 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
doc/lispref/eval.texi
View file

@ -558,6 +558,7 @@ and vectors.)
@defspec quote object @defspec quote object
This special form returns @var{object}, without evaluating it. This special form returns @var{object}, without evaluating it.
The returned value is a constant, and should not be modified.
@end defspec @end defspec
@cindex @samp{'} for quoting @cindex @samp{'} for quoting
@ -612,10 +613,12 @@ only part of a list, while computing and substituting other parts.
@dfn{Backquote constructs} allow you to quote a list, but @dfn{Backquote constructs} allow you to quote a list, but
selectively evaluate elements of that list. In the simplest case, it selectively evaluate elements of that list. In the simplest case, it
is identical to the special form @code{quote} is identical to the special form
@iftex @iftex
@code{quote}.
@end iftex @end iftex
@ifnottex @ifnottex
@code{quote}
(described in the previous section; @pxref{Quoting}). (described in the previous section; @pxref{Quoting}).
@end ifnottex @end ifnottex
For example, these two forms yield identical results: For example, these two forms yield identical results:
@ -693,6 +696,9 @@ Here are some examples:
@end group @end group
@end example @end example
If a subexpression of a backquote construct has no substitutions or
splices, it acts like @code{quote} in that it yields a constant that
should not be modified.
@node Eval @node Eval
@section Eval @section Eval