Re: [PATCH] docs: Explicitly state that the 'Fixes:' tag shouldn't split lines

From: Jonathan Corbet
Date: Fri Feb 22 2019 - 10:56:41 EST


On Tue, 19 Feb 2019 07:27:15 -0800
Sean Christopherson <sean.j.christopherson@xxxxxxxxx> wrote:

> ...and use a commit with an obnoxiously long summary in the example to
> make it abundantly clear that keeping the tag on a single line takes
> priority over wrapping at 75 columns. Without the explicit exemption,
> one might assume splitting the tag is acceptable, even encouraged, e.g.
> due to being conditioned by checkpatch's line length warning.
>
> Per Stephen's scripts[1] and implied by commit bf4daf12a9fb ("checkpatch:
> avoid some commit message long line warnings"), splitting the 'Fixes:'
> tag across multiple lines is a no-no, presumably because parsing multi-
> line tags is unnecessarily painful.
>
> [1] https://lkml.kernel.org/r/20190216183433.71b7cfa7@xxxxxxxxxxxxxxxx
>
> Cc: Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx>
> Signed-off-by: Sean Christopherson <sean.j.christopherson@xxxxxxxxx>

Applied, thanks.

jon