linux/Documentation/process
Sean Christopherson 19c3fe285c docs: Explicitly state that the 'Fixes:' tag shouldn't split lines
...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 bf4daf12a9 ("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@canb.auug.org.au

Cc: Stephen Rothwell <sfr@canb.auug.org.au>
Signed-off-by: Sean Christopherson <sean.j.christopherson@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2019-02-22 08:56:23 -07:00
..
1.Intro.rst doc:it_IT: add some process/* translations 2018-11-20 09:11:12 -07:00
2.Process.rst docs: fix typo in table describing 4.16 development cycle 2018-08-31 16:28:06 -06:00
3.Early-stage.rst Documentation/process: phrasofix 2017-09-26 14:53:51 -06:00
4.Coding.rst doc:process: add links where missing 2018-12-06 10:21:19 -07:00
5.Posting.rst doc:process: add links where missing 2018-12-06 10:21:19 -07:00
6.Followthrough.rst
7.AdvancedTopics.rst
8.Conclusion.rst doc:process: add links where missing 2018-12-06 10:21:19 -07:00
adding-syscalls.rst doc:it_IT: add some process/* translations 2018-11-20 09:11:12 -07:00
applying-patches.rst Documentation: change linux-4.x references to 5.x 2019-02-17 15:41:05 -07:00
changes.rst doc:process: add links where missing 2018-12-06 10:21:19 -07:00
clang-format.rst clang-format: add configuration file 2018-04-11 10:28:35 -07:00
code-of-conduct-interpretation.rst Code of Conduct Interpretation: Put in the proper URL for the committee 2018-10-22 07:33:36 +01:00
code-of-conduct.rst Code of Conduct: Change the contact email address 2018-10-22 07:33:36 +01:00
coding-style.rst coding-style: Clarify the expectations around bool 2019-01-20 19:07:39 -07:00
conf.py
deprecated.rst docs: Introduce deprecated APIs list 2018-10-18 12:22:43 -06:00
development-process.rst
email-clients.rst doc: Document suitability of IBM Verse for kernel development 2017-06-22 10:22:41 -06:00
howto.rst doc: process: complete removal of info about -git patches 2019-02-22 08:35:27 -07:00
index.rst The Compiler Attributes series 2018-11-01 18:34:46 -07:00
kernel-docs.rst doc: Change LXR references to elixir.bootlin.com 2019-02-01 16:05:03 -07:00
kernel-driver-statement.rst doc:it_IT: add some process/* translations 2018-11-20 09:11:12 -07:00
kernel-enforcement-statement.rst doc:it_IT: add some process/* translations 2018-11-20 09:11:12 -07:00
license-rules.rst doc: fix typos in license-rules.rst 2019-02-22 08:38:15 -07:00
magic-number.rst doc:it_IT: add some process/* translations 2018-11-20 09:11:12 -07:00
maintainer-pgp-guide.rst Documentation/process: updates to the PGP guide 2018-04-16 14:03:50 -06:00
management-style.rst doc:process: add links where missing 2018-12-06 10:21:19 -07:00
programming-language.rst Compiler Attributes: add Doc/process/programming-language.rst 2018-09-30 20:14:04 +02:00
stable-api-nonsense.rst doc: process: GPL -> GPL-compatible 2019-02-01 16:19:11 -07:00
stable-kernel-rules.rst stable-kernel-rules.rst: add link to networking patch queue 2019-02-01 16:11:55 -07:00
submit-checklist.rst docs: fix process/submit-checklist.rst Sphinx warning 2017-12-21 13:39:32 -07:00
submitting-drivers.rst doc:process: add links where missing 2018-12-06 10:21:19 -07:00
submitting-patches.rst docs: Explicitly state that the 'Fixes:' tag shouldn't split lines 2019-02-22 08:56:23 -07:00
volatile-considered-harmful.rst Documentation/atomic_ops.txt: convert to ReST markup 2016-11-30 17:40:52 -07:00