[nongnu] elpa/buttercup 1c762a5 200/340: Add documentation for :var and :var*

[ELPA Syncer]

branch: elpa/buttercup
commit 1c762a52647c96978ad52ca136a3e891e93617ba
Author: Kevin J. Foley <kfoley15@gmail.com>
Commit: Kevin J. Foley <kfoley15@gmail.com>

    Add documentation for :var and :var*
---
 docs/writing-tests.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/writing-tests.md b/docs/writing-tests.md
index c478111..3383467 100644
--- a/docs/writing-tests.md
+++ b/docs/writing-tests.md
@@ -202,6 +202,30 @@ as full sentences in traditional
       (expect t :to-equal t))))
 ```
 
+### Declaring Variables
+
+The `describe` macro supports the optional `:var` and `:var*` args.
+These bind variables for the suite by passing them as a varlist to the
+`let` and `let*` form respectively.
+
+```Emacs-Lisp
+(describe "A spec using :VAR"
+  :var ((foo 1))
+  (it "has access to the variables bound in :VAR"
+    (expect foo :to-be 1)))
+
+(describe "A spec using :VAR*"
+  :var* ((foo 1)
+        (bar (1+ foo)))
+  (it "has access to the variables bound in :VAR* which can refer \
+to symbols already bound"
+    (expect bar :to-be 2)))
+```
+
+It's important to note that `lexical-binding` must be `non-nil` for
+`:var` and `:var*` to work properly. Within a test file this is
+usually set using a local file variable.
+
 ### Setup and Teardown
 
 To help a test suite DRY up any duplicated setup and teardown code,