[Emacs-diffs] /srv/bzr/emacs/trunk r104892: Clarify that SETFUNCTION is only used in the Customize user interface

[Lars Magne Ingebrigtsen]

------------------------------------------------------------
revno: 104892
committer: Lars Magne Ingebrigtsen <address@hidden>
branch nick: trunk
timestamp: Sun 2011-07-03 01:52:35 +0200
message:
  Clarify that SETFUNCTION is only used in the Customize user interface
  (bug#6089).
modified:
  doc/lispref/ChangeLog
  doc/lispref/customize.texi
  lisp/ChangeLog
  lisp/custom.el

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-07-02 21:38:52 +0000
+++ b/doc/lispref/ChangeLog     2011-07-02 23:52:35 +0000
@@ -1,5 +1,8 @@
 2011-07-02  Lars Magne Ingebrigtsen  <address@hidden>
 
+       * customize.texi (Variable Definitions): Clarify that SETFUNCTION
+       is only used in the Customize user interface (bug#6089).
+
        * display.texi (Showing Images): Mention the point of sliced
        images (bug#7836).
 

=== modified file 'doc/lispref/customize.texi'
--- a/doc/lispref/customize.texi        2011-07-02 13:36:11 +0000
+++ b/doc/lispref/customize.texi        2011-07-02 23:52:35 +0000
@@ -326,11 +326,12 @@
 @item :set @var{setfunction}
 @kindex address@hidden, @code{defcustom} keyword}
 Specify @var{setfunction} as the way to change the value of this
-option.  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
address@hidden is @code{set-default}.
+option when using the Customize user interface.  The function
address@hidden 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
address@hidden
 
 @item :get @var{getfunction}
 @kindex address@hidden, @code{defcustom} keyword}

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2011-07-02 22:55:41 +0000
+++ b/lisp/ChangeLog    2011-07-02 23:52:35 +0000
@@ -1,5 +1,8 @@
 2011-07-02  Lars Magne Ingebrigtsen  <address@hidden>
 
+       * custom.el (defcustom): Clarify that :set is only used in the
+       Customize user interface (bug#6089).
+
        * progmodes/flymake.el (flymake-mode): If the buffer isn't
        associated with a file, refuse to run instead of erroring out
        (bug#6084).

=== modified file 'lisp/custom.el'
--- a/lisp/custom.el    2011-06-30 01:39:52 +0000
+++ b/lisp/custom.el    2011-07-02 23:52:35 +0000
@@ -215,7 +215,8 @@
        variable.  It takes two arguments, the symbol and value
        given in the `defcustom' call.  The default is
        `custom-initialize-reset'.
-:set   VALUE should be a function to set the value of the symbol.
+: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'.
 :get   VALUE should be a function to extract the value of symbol.