|
From: | Dmitry Gutov |
Subject: | Re: master 1e3b0f2: Improve doc strings of project.el |
Date: | Mon, 13 Jul 2020 21:26:23 +0300 |
User-agent: | Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 |
On 13.07.2020 11:53, Eli Zaretskii wrote:
I might be wrong, but in that case I think Dmitry's viewpoint is that this information should not be placed in the doc strings, but in the comments in the source file.Maybe so, but the suggestion to move what I added to the doc strings into comments was never voiced by Dmitry until the very last message, and even there he is still firmly against documenting the form of the return value, no matter where.
One the contrary, I did say that this kind of information is better suited for comments, if we must have it.
For example, you can add it to project-try-vc somewhere. To me it seems gratuitous/too obvious from the implementation already, but I don't object to it on principle.
[Prev in Thread] | Current Thread | [Next in Thread] |