From 6b88e570d87bbf8e3e36f6cb25a3791d047e8c35 Mon Sep 17 00:00:00 2001 From: Juanma Barranquero Date: Wed, 19 Mar 2014 00:31:17 +0100 Subject: 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. --- lisp/custom.el | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'lisp/custom.el') 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 -- cgit v1.2.1