bug-gnu-emacs
[Top][All Lists]
Advanced

[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






reply via email to

[Prev in Thread] Current Thread [Next in Thread]