[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: linum-mode docstring is unclear
From: |
John Shahid |
Subject: |
Re: linum-mode docstring is unclear |
Date: |
Sun, 25 Feb 2018 15:29:01 -0500 |
User-agent: |
mu4e 1.0-alpha3; emacs 26.0.91 |
I guess any mode that uses define-minor-mode is susceptible to this kind
of problem. That said, I'm not aware about other modes with similar
phrasing issues. I also sent a patch to fix linum-mode docstring to
bug-gnu-emacs@gnu.org.
cheers,
-js
Emanuel Berg <moasen@zoho.com> writes:
> John Shahid wrote:
>
>> I think the linum-mode docstring is unclear
>> about when the mode is turned on when called
>> from Lisp. According to the docstring:
>>
>> ".... If called from Lisp, enable the mode
>> if ARG is omitted or nil."
>>
>> This isn't true. In fact, passing any value
>> other than 0 will turn on the mode.
>> Furthermore, the docstring doesn't mention
>> that passing 'toggle will toggle the state of
>> the mode. WDYT, is that something that can
>> be/need clarification ?
>
> Well, obviously :)
>
> I wonder if this is a general problem/phrasing
> that appears more than once?