[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/setup 7e3d025 05/25: Update documentation for :option a
From: |
Stefan Monnier |
Subject: |
[elpa] externals/setup 7e3d025 05/25: Update documentation for :option and :local-set |
Date: |
Wed, 14 Apr 2021 18:49:00 -0400 (EDT) |
branch: externals/setup
commit 7e3d025823ae3c32ed39d06bb74462d3aed4158e
Author: Philip K <philipk@posteo.net>
Commit: Philip K <philipk@posteo.net>
Update documentation for :option and :local-set
---
setup.el | 29 +++++++++++++++++++++--------
1 file changed, 21 insertions(+), 8 deletions(-)
diff --git a/setup.el b/setup.el
index 8f0017b..1bcc501 100644
--- a/setup.el
+++ b/setup.el
@@ -346,10 +346,15 @@ the first FEATURE."
`(customize-set-variable ',name ,val "Modified by `setup'"))
:documentation "Set the option NAME to VAL.
NAME may be a symbol, or a cons-cell. If NAME is a cons-cell, it
-will use the car value to modify the behaviour. If NAME has the
-form (append VAR), VAL is appended to VAR. If NAME has the
-form (prepend VAR), VAL is prepended to VAR. If NAME has the
-form (remove VAR), VAL is removed from VAR."
+will use the car value to modify the behaviour. These forms are
+supported:
+
+(append VAR) Assuming VAR designates a list, add VAL as its last
+ element, unless it is already member of the list.
+
+(prepend VAR) Assuming VAR designates a list, add VAL to the
+ beginning, unless it is already member of the
+ list."
:debug '(sexp form)
:repeatable t)
@@ -385,10 +390,18 @@ form (remove VAR), VAL is removed from VAR."
`(add-hook setup-hook (lambda () (setq-local ,name ,val))))
:documentation "Set the value of NAME to VAL in buffers of the current mode.
NAME may be a symbol, or a cons-cell. If NAME is a cons-cell, it
-will use the car value to modify the behaviour. If NAME has the
-form (append VAR), VAL is appended to VAR. If NAME has the
-form (prepend VAR), VAL is prepended to VAR. If NAME has the
-form (remove VAR), VAL is removed from VAR."
+will use the car value to modify the behaviour. These forms are
+supported:
+
+(append VAR) Assuming VAR designates a list, add VAL as its last
+ element, unless it is already member of the list.
+
+(prepend VAR) Assuming VAR designates a list, add VAL to the
+ beginning, unless it is already member of the
+ list.
+
+(remove VAR) Assuming VAR designates a list, remove all instances
+ of VAL."
:debug '(sexp form)
:repeatable t)
- [elpa] externals/setup 5e201d7 06/25: Use custom-load-symbol for modifying :option moderations, (continued)
- [elpa] externals/setup 5e201d7 06/25: Use custom-load-symbol for modifying :option moderations, Stefan Monnier, 2021/04/14
- [elpa] externals/setup ccf2ebf 09/25: Copy commentary changes to README, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 43092c2 11/25: Mention if no local macros are defined in setup docstring, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 7562f2f 12/25: Prevent :option values from being saved in the user theme, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 9a67209 14/25: Always call custom-load-symbol before customizing an option, Stefan Monnier, 2021/04/14
- [elpa] externals/setup f764229 15/25: Explain how :with-feature sets an implicit mode, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 439b4a8 02/25: Raise an error if lexical binding is not enabled, Stefan Monnier, 2021/04/14
- [elpa] externals/setup a77d9f2 03/25: Don't apply kbd to symbols in :global, :bind, :unbind and :rebind, Stefan Monnier, 2021/04/14
- [elpa] externals/setup ec23802 04/25: Check for duplicate elements with append/remove, Stefan Monnier, 2021/04/14
- [elpa] externals/setup df6f6eb 13/25: Add note on modifying option names, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 7e3d025 05/25: Update documentation for :option and :local-set,
Stefan Monnier <=
- [elpa] externals/setup e1d51a3 07/25: Add (remove VAR) form for :option, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 7699c78 08/25: Reindent commentary examples, Stefan Monnier, 2021/04/14
- [elpa] externals/setup c707965 10/25: Handle symbols in :global, :bind, :unbind and :rebind, Stefan Monnier, 2021/04/14
- [elpa] externals/setup ea52eb1 17/25: Add note that :option does not manipulate user theme., Stefan Monnier, 2021/04/14
- [elpa] externals/setup 2503ad0 25/25: Expand load path for :load-from, Stefan Monnier, 2021/04/14
- [elpa] externals/setup d44d333 20/25: Add :load-from macro, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 5728369 18/25: Fix shell example in README and Commentary section, Stefan Monnier, 2021/04/14
- [elpa] externals/setup 22b5312 23/25: Add :file-match macro, Stefan Monnier, 2021/04/14
- [elpa] externals/setup f7d5906 16/25: Replace customize-set-variable with the necessary parts, Stefan Monnier, 2021/04/14
- [elpa] externals/setup b7aa594 19/25: Allow :hook-into to also use hook names, Stefan Monnier, 2021/04/14