]> git.eshelyaron.com Git - emacs.git/commitdiff
Document that quoting yields constants
authorPaul Eggert <eggert@cs.ucla.edu>
Sun, 19 Apr 2020 16:37:51 +0000 (09:37 -0700)
committerPaul Eggert <eggert@cs.ucla.edu>
Sun, 19 Apr 2020 20:29:57 +0000 (13:29 -0700)
* doc/lispref/eval.texi (Quoting, Backquote):
Mention that quoted expressions yield a constant (Bug#40693).

doc/lispref/eval.texi

index f6f36ed3427883f2c1cbfedf34251d7a6032b489..46cfab164b75b3ed01e047f0a27c6cb3d67bceeb 100644 (file)
@@ -558,6 +558,7 @@ and vectors.)
 
 @defspec quote object
 This special form returns @var{object}, without evaluating it.
+The returned value is a constant, and should not be modified.
 @end defspec
 
 @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
 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
+@code{quote}.
 @end iftex
 @ifnottex
+@code{quote}
 (described in the previous section; @pxref{Quoting}).
 @end ifnottex
 For example, these two forms yield identical results:
@@ -693,6 +696,9 @@ Here are some examples:
 @end group
 @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
 @section Eval