[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/setup d1a55e7 07/24: Simplify setup docstring
From: |
Stefan Monnier |
Subject: |
[elpa] externals/setup d1a55e7 07/24: Simplify setup docstring |
Date: |
Thu, 25 Mar 2021 13:42:35 -0400 (EDT) |
branch: externals/setup
commit d1a55e753edd5a659cc29f9c50a50c7ed5357d43
Author: Philip K <philipk@posteo.net>
Commit: Philip K <philipk@posteo.net>
Simplify setup docstring
---
setup.el | 15 +++++++--------
1 file changed, 7 insertions(+), 8 deletions(-)
diff --git a/setup.el b/setup.el
index 4de72e9..94e867a 100644
--- a/setup.el
+++ b/setup.el
@@ -80,9 +80,11 @@ Do not modify this variable by hand. Instead use
(defun setup-make-docstring ()
"Return a docstring for `setup'."
(with-temp-buffer
- (insert (documentation (symbol-function 'setup) 'raw))
- (dolist (sym (sort (mapcar #'car setup-macros)
- #'string-lessp))
+ (insert (documentation (symbol-function 'setup) 'raw)
+ "\n\n"
+ "Within BODY, `setup' provides these local macros:")
+ (dolist (sym (sort (mapcar #'car setup-macros) #'string-lessp))
+ (newline 2)
(let ((sig (mapcar
(lambda (arg)
(if (string-match "\\`&" (symbol-name arg))
@@ -91,17 +93,14 @@ Do not modify this variable by hand. Instead use
(get sym 'setup-signature))))
(insert (format " - %s\n\n" (cons sym sig))
(or (get sym 'setup-documentation)
- "No documentation.")
- "\n\n")))
+ "No documentation."))))
(buffer-string)))
;;;###autoload
(defmacro setup (name &rest body)
"Configure feature or subsystem NAME.
BODY may contain special forms defined by `setup-define', but
-will otherwise just be evaluated as is.
-
-The following local macros are defined in a `setup' body:\n\n"
+will otherwise just be evaluated as is."
(declare (debug (&rest &or [symbolp sexp] form))
(indent defun))
(when (consp name)
- [elpa] externals/setup updated (8712651 -> 7a78f66), Stefan Monnier, 2021/03/25
- [elpa] externals/setup 672876d 03/24: Reorder setup-define options consistently., Stefan Monnier, 2021/03/25
- [elpa] externals/setup d0262df 06/24: Reindent example in Commentary section, Stefan Monnier, 2021/03/25
- [elpa] externals/setup cb8085e 01/24: Remove debug specification for :hook, Stefan Monnier, 2021/03/25
- [elpa] externals/setup a090d3b 02/24: Add :advise macro to wrap advice-add, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 5dfdfb7 04/24: Remove setup-edebug-specifications declaration, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 4c1ca62 05/24: Make explicit that setup-macros is modified by setup-define., Stefan Monnier, 2021/03/25
- [elpa] externals/setup f3e1b0f 10/24: Link to repository, Stefan Monnier, 2021/03/25
- [elpa] externals/setup d1a55e7 07/24: Simplify setup docstring,
Stefan Monnier <=
- [elpa] externals/setup 483c938 08/24: Mention that :when-loaded is bad style, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 1893abc 13/24: Document :shorthand and extractors, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 2e18255 23/24: Always push cons as name onto body, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 844b6bc 15/24: Removed unnecessary unquote in :unbind, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 8f586c3 16/24: Fix hide-mode handling for the first element in minor-mode-alist, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 58cb897 09/24: Remove empty lines in docstrings, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 48658fb 20/24: Fix broken markup in README, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 903564b 21/24: Add if-package and if-feature macros, Stefan Monnier, 2021/03/25
- [elpa] externals/setup f3d4d27 11/24: Replace (function-)form with sexp where necessary, Stefan Monnier, 2021/03/25
- [elpa] externals/setup 546c5f2 12/24: Bump version to 0.1.2, Stefan Monnier, 2021/03/25