summaryrefslogtreecommitdiff
path: root/lisp/emacs-lisp
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2019-10-12 21:34:56 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2019-10-12 21:34:56 +0200
commit3fcfa8071ac820c2a857b890de31ba5517d7249e (patch)
tree931c6b302912dde174298661e345e78c6e62b21f /lisp/emacs-lisp
parentcb24f4a145d52fcef858972be6a5c71b7f06eb11 (diff)
downloademacs-3fcfa8071ac820c2a857b890de31ba5517d7249e.tar.gz
emacs-3fcfa8071ac820c2a857b890de31ba5517d7249e.tar.bz2
emacs-3fcfa8071ac820c2a857b890de31ba5517d7249e.zip
ert-deftest macro doc string clarification
* lisp/emacs-lisp/ert.el (ert-deftest): Mention that macros are expanded when defined, not when tested (bug#21742).
Diffstat (limited to 'lisp/emacs-lisp')
-rw-r--r--lisp/emacs-lisp/ert.el4
1 files changed, 4 insertions, 0 deletions
diff --git a/lisp/emacs-lisp/ert.el b/lisp/emacs-lisp/ert.el
index da241e6304f..68762b0752c 100644
--- a/lisp/emacs-lisp/ert.el
+++ b/lisp/emacs-lisp/ert.el
@@ -192,6 +192,10 @@ Tests that are expected to fail can be marked as such
using :expected-result. See `ert-test-result-type-p' for a
description of valid values for RESULT-TYPE.
+Macros in BODY are expanded when the test is defined, not when it
+is run. If a macro (possibly with side effects) is to be tested,
+it has to be wrapped in `(eval (quote ...))'.
+
\(fn NAME () [DOCSTRING] [:expected-result RESULT-TYPE] \
[:tags \\='(TAG...)] BODY...)"
(declare (debug (&define :name test