[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#35163: 25.1; `narrow-to-region' docstring no mention of args
From: |
Noam Postavsky |
Subject: |
bug#35163: 25.1; `narrow-to-region' docstring no mention of args |
Date: |
Mon, 08 Apr 2019 19:09:39 -0400 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.1.91 (gnu/linux) |
> From: Eli Zaretskii <eliz@gnu.org>
>> From: Glenn Morris <rgm@gnu.org>
>> OP wants every doc string to literally contain the upper-case argument
>> names, ie START and END in this case (as per eg checkdoc's "Argument ...
>> should appear (as ...) in the doc string"). If you agree, it's a trivial
>> change. If not, close as wontfix.
>
> Thanks, fixed.
>
>> (People who have particular ideas about doc strings could save everyone
>> a lot of time by sending patches.)
>
> Or at least a clear description of the problem.
To be fair, message [11] is fairly clear and pretty close to what Glenn
wrote (perhaps it misses the emphasis on satisfying checkdoc). Things
unfortunately derailed after that.
An 80+ line elisp riddle on a report about a docstring bug is surely a
sign something has gone horribly wrong...
[11]: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=35163#11
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, (continued)
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Emanuel Berg, 2019/04/08
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Basil L. Contovounesios, 2019/04/08
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Emanuel Berg, 2019/04/09
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Robert Pluim, 2019/04/09
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Emanuel Berg, 2019/04/09
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Robert Pluim, 2019/04/09
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Emanuel Berg, 2019/04/09
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Robert Pluim, 2019/04/11
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Emanuel Berg, 2019/04/12
- bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Eli Zaretskii, 2019/04/09
Message not available
bug#35163: 25.1; `narrow-to-region' docstring no mention of args, Eli Zaretskii, 2019/04/09