emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: master 1e3b0f2: Improve doc strings of project.el


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.



reply via email to

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