summaryrefslogtreecommitdiff
path: root/lisp/custom.el
diff options
context:
space:
mode:
authorJuanma Barranquero <lekktu@gmail.com>2014-03-19 00:31:17 +0100
committerJuanma Barranquero <lekktu@gmail.com>2014-03-19 00:31:17 +0100
commit6b88e570d87bbf8e3e36f6cb25a3791d047e8c35 (patch)
treeb112a3e1599406ab812dc1c42c01a86443db72c4 /lisp/custom.el
parent4d99c93d27d47ff9f5fb941fe92e3b4b9cf5cf43 (diff)
downloademacs-6b88e570d87bbf8e3e36f6cb25a3791d047e8c35.tar.gz
Recommend not modifying :set's value arg in defcustom (bug#16755).
* doc/lispref/customize.texi (Variable Definitions): * lisp/custom.el (defcustom): Recommend avoiding destructive modification of the value argument of :set.
Diffstat (limited to 'lisp/custom.el')
-rw-r--r--lisp/custom.el7
1 files changed, 4 insertions, 3 deletions
diff --git a/lisp/custom.el b/lisp/custom.el
index 09431c454ec..c30ad7cb213 100644
--- a/lisp/custom.el
+++ b/lisp/custom.el
@@ -232,9 +232,10 @@ The following keywords are meaningful:
given in the `defcustom' call. The default is
`custom-initialize-reset'.
:set VALUE should be a function to set the value of the symbol
- when using the Customize user interface.
- It takes two arguments, the symbol to set and the value to
- give it. The default choice of function is `set-default'.
+ when using the Customize user interface. It takes two arguments,
+ the symbol to set and the value to give it. The function should
+ not modify its value argument destructively. The default choice
+ of function is `set-default'.
:get VALUE should be a function to extract the value of symbol.
The function takes one argument, a symbol, and should return
the current value for that symbol. The default choice of function