[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands
From: |
Drew Adams |
Subject: |
bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands |
Date: |
Mon, 8 Jun 2020 10:38:43 -0700 (PDT) |
> > That's misleading enough to make me wonder whether,
> > in that case, it might be better to say nothing at
> > all about the call-from-Lisp case, forcing Lisp
> > users to consult the code.
>
> How about leaving only cases like ARG -> '- undocumented?
>
> When called from Lisp, the mode command toggles the mode if the argument
> is `toggle', disables the mode if the argument is a non-positive
> integer, and enables the mode if the argument is a positive integer or
> omitted or nil.
That's what we say now, and the reason I filed the bug.
> Good enough for daily business. ...
Not good enough for me. ;-)
Consider a case where some command A invokes a minor-mode
command B, to turn B on or off for some purpose/extent.
Consider the case where A's prefix arg is passed to B, to
do that.
The programmer writing the Lisp code to define A should
know that s?he can just pass the raw prefix arg. The
resulting code will be simpler, easier to read, etc.
I see no reason at all why we wouldn't provide an accurate
(complete) description of what ARG is for Lisp use.
What do we gain by not doing this right?
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, (continued)
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Eli Zaretskii, 2020/06/06
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Drew Adams, 2020/06/06
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Eli Zaretskii, 2020/06/06
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Drew Adams, 2020/06/06
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Michael Heerdegen, 2020/06/07
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Eli Zaretskii, 2020/06/07
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Michael Heerdegen, 2020/06/07
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Drew Adams, 2020/06/07
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Michael Heerdegen, 2020/06/08
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands,
Drew Adams <=
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Michael Heerdegen, 2020/06/09
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Eli Zaretskii, 2020/06/09
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Michael Heerdegen, 2020/06/09
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Drew Adams, 2020/06/09
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Drew Adams, 2020/06/09
- bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands, Drew Adams, 2020/06/07