Re: [PATCH] scripts/kernel-doc: optionally treat warnings as errors

From: Pierre-Louis Bossart
Date: Mon Jul 27 2020 - 19:18:33 EST




On 7/27/20 6:15 PM, Jonathan Corbet wrote:
On Mon, 27 Jul 2020 18:09:21 -0500
Pierre-Louis Bossart <pierre-louis.bossart@xxxxxxxxxxxxxxx> wrote:

Both points were covered by the sentence "A command-line option is
provided to the kernel-doc script, as well as a check on environment
variables to turn this optional behavior on".


Making that more prominent would be good, but a changelog like this should
say *which* command-line option was provided, and *which* environment
variables are checked. Don't make people go digging through the patch to
figure it out. See what I'm getting at?

ok. I tried to avoid duplicating what's in the code, since it's relatively minimal and self-explanatory but I see your point. Will send a v2.