GNU bug report logs -
#14875
24.3.50; doc of :variable in `define-minor-mode' - lamentable
Previous Next
Reported by: Drew Adams <drew.adams <at> oracle.com>
Date: Mon, 15 Jul 2013 20:54:02 UTC
Severity: wishlist
Merged with 21709
Found in versions 24.3.50, 25.0.50
Fixed in version 28.1
Done: Lars Ingebrigtsen <larsi <at> gnus.org>
Bug is archived. No further changes may be made.
To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 14875 in the body.
You can then email your comments to 14875 AT debbugs.gnu.org in the normal way.
Toggle the display of automated, internal messages from the tracker.
Report forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#14875
; Package
emacs
.
(Mon, 15 Jul 2013 20:54:02 GMT)
Full text and
rfc822 format available.
Acknowledgement sent
to
Drew Adams <drew.adams <at> oracle.com>
:
New bug report received and forwarded. Copy sent to
bug-gnu-emacs <at> gnu.org
.
(Mon, 15 Jul 2013 20:54:03 GMT)
Full text and
rfc822 format available.
Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):
1. Both (elisp) `Defining Minor Modes' and the doc string say the same
thing, verbatim. The manual should explain better.
2. The description/explanation is incomplete/confusing/gobbledygook, at
best.
It says that PLACE can be a "generalized variable", without giving any
explanation of what a generalized variable is, and without
cross-referencing any doc that describes such a thing.
It says that PLACE can also be a cons (GET . SET). In this case, it
says that "SET is a function that takes one argument, the new state, and
sets it".
Huh? It takes the NEW state as argument? If so, where did that new state
come from? And then it "sets" the new state? Huh? Does it just set it to
what it already was (the "new state" argument)? Or does "set" here perhaps
imply setting the value to non-nil (as in setting a bit)?
It's not clear at all what the SET of (GET . SET) (1) accepts as arg,
(2) does as its main (standard) effect, or (3) returns as a value (if that
matters).
It says that if PLACE is specified as a variable then "this function
does not define a MODE variable (nor any of the terms used in :variable)".
Huh? Does "variable" here include the "generalized variable" case? Does
"this function" refer to the SET function of the preceding sentence? Or
does it refer to the minor-mode function? What on Earth does it mean for
the function (either of those functions, or whatever function is meant)
to not define "any of the terms used in :variable"?
I honestly understand almost nothing here. :variable does not define
any of the terms used in :variable? Huh?
Please, please. Users deserve better. Give us a break. Please clear
this up.
3. And as is too often the case, the "For example,..." at the end gives
a too-trivial example that shows none of the things that someone might
really have a question about.
In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
of 2013-07-01 on LEG570
Bzr revision: 113246 lekktu <at> gmail.com-20130701165437-ea20s94hqwp3ttaj
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --prefix=/c/usr --enable-checking CFLAGS='-O0 -g3'
CPPFLAGS='-DGLYPH_DEBUG=1 -I/c/usr/include''
Merged 14875 21709.
Request was from
Glenn Morris <rgm <at> gnu.org>
to
control <at> debbugs.gnu.org
.
(Mon, 19 Oct 2015 19:52:02 GMT)
Full text and
rfc822 format available.
bug marked as fixed in version 28.1, send any further explanations to
21709 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com>
Request was from
Lars Ingebrigtsen <larsi <at> gnus.org>
to
control <at> debbugs.gnu.org
.
(Mon, 16 Aug 2021 12:26:01 GMT)
Full text and
rfc822 format available.
bug archived.
Request was from
Debbugs Internal Request <help-debbugs <at> gnu.org>
to
internal_control <at> debbugs.gnu.org
.
(Tue, 14 Sep 2021 11:24:04 GMT)
Full text and
rfc822 format available.
This bug report was last modified 2 years and 223 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.