[elpa] externals/setup 7fddc97 17/19: Explain usage of keywords for local macros

[Stefan Monnier]

branch: externals/setup
commit 7fddc97c83e46c9f3adc6869caaa7d312a077bb7
Author: Philip K <philipk@posteo.net>
Commit: Philip K <philipk@posteo.net>

    Explain usage of keywords for local macros
---
 setup.el | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/setup.el b/setup.el
index e7bd07c..48df903 100644
--- a/setup.el
+++ b/setup.el
@@ -151,6 +151,11 @@ A documentation string.
 A edebug specification, see Info node `(elisp) Specification List'.
 If not given, it is assumed nothing is evaluated."
   (declare (indent 1))
+  ;; NB.: NAME is not required to by a keyword, even though all macros
+  ;;      specified on the next page use keywords.  The rationale for
+  ;;      this is currently that there is no clean way to "locally"
+  ;;      modify indentation, without setting `lisp-indent-function',
+  ;;      chaining the indentation behaviour everywhere.
   (cl-assert (symbolp name))
   (cl-assert (functionp fn))
   (cl-assert (listp opts))