diff options
| author | Juanma Barranquero <lekktu@gmail.com> | 2014-03-19 00:31:17 +0100 |
|---|---|---|
| committer | Juanma Barranquero <lekktu@gmail.com> | 2014-03-19 00:31:17 +0100 |
| commit | 6b88e570d87bbf8e3e36f6cb25a3791d047e8c35 (patch) | |
| tree | b112a3e1599406ab812dc1c42c01a86443db72c4 /doc/lispref/customize.texi | |
| parent | 4d99c93d27d47ff9f5fb941fe92e3b4b9cf5cf43 (diff) | |
| download | emacs-6b88e570d87bbf8e3e36f6cb25a3791d047e8c35.tar.gz emacs-6b88e570d87bbf8e3e36f6cb25a3791d047e8c35.tar.bz2 emacs-6b88e570d87bbf8e3e36f6cb25a3791d047e8c35.zip | |
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 'doc/lispref/customize.texi')
| -rw-r--r-- | doc/lispref/customize.texi | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi index 094beef01ec..0c6497fb4ef 100644 --- a/doc/lispref/customize.texi +++ b/doc/lispref/customize.texi @@ -353,8 +353,9 @@ option when using the Customize interface. The function @var{setfunction} should take two arguments, a symbol (the option name) and the new value, and should do whatever is necessary to update the value properly for this option (which may not mean simply setting -the option as a Lisp variable). The default for @var{setfunction} is -@code{set-default}. +the option as a Lisp variable); preferably, though, it should not +modify its value argument destructively. The default for +@var{setfunction} is @code{set-default}. If you specify this keyword, the variable's documentation string should describe how to do the same job in hand-written Lisp code. |