Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

From: Jonathan Corbet
Date: Thu May 10 2018 - 09:16:11 EST


On Thu, 10 May 2018 14:23:35 +0200
Andrea Parri <andrea.parri@xxxxxxxxxxxxxxxxxxxx> wrote:

> 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. Surely an extra colon is not going to
force you to run screaming to the protective embrace of Firefox...?

Thanks,

jon