Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings
From: Andrea Parri <hidden>
Date: 2018-05-10 16:52:30
Also in:
lkml
From: Andrea Parri <hidden>
Date: 2018-05-10 16:52:30
Also in:
lkml
On Thu, May 10, 2018 at 07:15:59AM -0600, Jonathan Corbet wrote:
On Thu, 10 May 2018 14:23:35 +0200 Andrea Parri [off-list ref] wrote:quoted
only remember that other people (including some developers running into the "disadventure" of opening an RST doc. from their preferred text editor and being brought to conclude: "WTH! I need to open a web browser, I guess...") _use_ such doc. and _do care_ about it, and that what might be an improvement for some people might look as "vandalizing" to others.If you have an example of a place where use of a web browser has been made mandatory, please point it out. Avoiding that was at the top of the list of explicit requirements.
That's all I need.
Surely an extra colon is not going to force you to run screaming to the protective embrace of Firefox...?
Let me put it in these terms: I believe that that extra colon (or the "diagram" keywork) is not going to improve/help my use of the doc. ;D Andrea
Thanks, jon
-- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html