bug#81547: 31.0.90; Defcustom's docstring does not mention new `BUFFER-LOCAL' optional argument for :set function
Eli Zaretskii <[email protected]> Tue, 04 Aug 2026 14:34:26 +0300
| Newsgroups | gmane.emacs.bugs |
|---|---|
| Message-ID | <[email protected]> |
> From: Antonio Romano <[email protected]> > Date: Mon, 03 Aug 2026 21:25:47 +0000 > > According to NEWS: > > --- > ** New macro 'setopt-local'. > This is the buffer-local version of 'setopt' for user options rather > than plain variables and uses 'custom-set'/'set-local' to set variable > values. A new argument, BUFFER-LOCAL, is passed to 'custom-set' > functions to indicate the buffer-local context. > --- > > However, this is currently `defcustom' docstring regarding `:set': > > --- > :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 function should > not modify its value argument destructively. The default choice > of function is `set-default-toplevel-value'. If this keyword is > defined, modifying the value of SYMBOL via `setopt' will call the > function specified by VALUE to install the new value. > --- > > When it now takes two arguments plus an optional argument called > BUFFER-LOCAL that is non-nil when the value is set through > `setopt-local'. Thanks, fixed on the emacs-31 release branch.