summaryrefslogtreecommitdiff
path: root/doc/lispref/eval.texi
diff options
context:
space:
mode:
authorBasil L. Contovounesios <contovob@tcd.ie>2019-04-17 16:34:47 +0100
committerBasil L. Contovounesios <contovob@tcd.ie>2019-04-22 13:48:20 +0100
commit4430a9b54fca266e48d0eb8b72d83706910f10b8 (patch)
tree182029118aaac0c6702ac50dc787a3e0c952b891 /doc/lispref/eval.texi
parenta2a51b4e94d3e058a71815cb309a21b707c3473b (diff)
downloademacs-4430a9b54fca266e48d0eb8b72d83706910f10b8.tar.gz
Improve pure and side-effect-free docs
For discussion, see thread starting at: https://lists.gnu.org/archive/html/emacs-devel/2019-04/msg00316.html * doc/lispref/customize.texi (Composite Types): Do not overspecify :match-alternatives predicates. * doc/lispref/eval.texi (Intro Eval): Anchor definition of "side effect" for cross-referencing... * doc/lispref/functions.texi (What Is a Function): ...from here. Define what a pure function is. * doc/lispref/internals.texi (Writing Emacs Primitives): Describe currently preferred approach to marking primitives as pure and side-effect-free. * doc/lispref/symbols.texi (Standard Properties): Expand description of pure and side-effect-free properties.
Diffstat (limited to 'doc/lispref/eval.texi')
-rw-r--r--doc/lispref/eval.texi1
1 files changed, 1 insertions, 0 deletions
diff --git a/doc/lispref/eval.texi b/doc/lispref/eval.texi
index db42dfb6373..39c5a1ec506 100644
--- a/doc/lispref/eval.texi
+++ b/doc/lispref/eval.texi
@@ -87,6 +87,7 @@ also temporarily alter the environment by binding variables
(@pxref{Local Variables}).
@cindex side effect
+@anchor{Definition of side effect}
Evaluating a form may also make changes that persist; these changes
are called @dfn{side effects}. An example of a form that produces a
side effect is @code{(setq foo 1)}.