From: Richard M. Stallman Date: Thu, 24 Jun 2004 20:17:34 +0000 (+0000) Subject: (Variable Definitions): Note about doc strings and :set. X-Git-Tag: ttn-vms-21-2-B4~5645 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=379031d1fd95b5f038267f2b162deb40e1461c52;p=emacs.git (Variable Definitions): Note about doc strings and :set. --- diff --git a/lispref/customize.texi b/lispref/customize.texi index 5b95e911f85..c2e31462e0e 100644 --- a/lispref/customize.texi +++ b/lispref/customize.texi @@ -194,6 +194,11 @@ than one occasion. You should normally avoid using backquotes in @var{default} because they are not expanded when editing the value, causing list values to appear to have the wrong structure. +If you specify the @code{:set} option, to make the variable take other +special actions when set through the customization buffer, the +variable's documentation string should tell the user specifically how +to do the same job in hand-written Lisp code. + When you evaluate a @code{defcustom} form with @kbd{C-M-x} in Emacs Lisp mode (@code{eval-defun}), a special feature of @code{eval-defun} arranges to set the variable unconditionally, without testing whether