[elpa] externals/setup 7e3d025 05/25: Update documentation for :option and :local-set

[Stefan Monnier]

branch: externals/setup
commit 7e3d025823ae3c32ed39d06bb74462d3aed4158e
Author: Philip K <phil...@posteo.net>
Commit: Philip K <phil...@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)