]> git.eshelyaron.com Git - emacs.git/commitdiff
Doc fix in let-alist for keys with nil value
authorStefan Kangas <stefankangas@gmail.com>
Tue, 26 Sep 2023 16:13:00 +0000 (18:13 +0200)
committerStefan Kangas <stefankangas@gmail.com>
Thu, 28 Sep 2023 22:28:28 +0000 (00:28 +0200)
* lisp/emacs-lisp/let-alist.el (let-alist): Clarify that keys with a
nil value will give the same result as if they were missing.

lisp/emacs-lisp/let-alist.el

index d9ad46b2af77ec2985dc19cc71b1e0609732e130..1f08cc41a5c597bf975ce626a96cb8e562c38439 100644 (file)
@@ -60,7 +60,7 @@
 ;; the variables of the outer one.  You can, however, access alists
 ;; inside the original alist by using dots inside the symbol, as
 ;; displayed in the example above by the `.site.contents'.
-;;
+
 ;;; Code:
 \f
 
@@ -139,7 +139,14 @@ essentially expands to
 If you nest `let-alist' invocations, the inner one can't access
 the variables of the outer one.  You can, however, access alists
 inside the original alist by using dots inside the symbol, as
-displayed in the example above."
+displayed in the example above.
+
+Note that there is no way to differentiate the case where a key
+is missing from when it is present, but its value is nil.  Thus,
+the following form evaluates to nil:
+
+    (let-alist '((some-key . nil))
+      .some-key)"
   (declare (indent 1) (debug t))
   (let ((var (make-symbol "alist")))
     `(let ((,var ,alist))