[RFC] [wwwdocs] Rewrite docs on commit message and patch format

Segher Boessenkool segher@kernel.crashing.org
Tue Jun 15 12:10:13 GMT 2021


On Mon, Jun 14, 2021 at 06:12:24PM -0600, Martin Sebor via Gcc-patches wrote:
> The text looks more detailed and arguably more accurate but also
> makes it sound more complicated and rigid than necessary.

+1

> (why ask for no space and not, for example PR #nnnnn?)

Because it is shorter.  If your lines are too long (>50 chars) the info
will not show up in lists; if that is okay that info does not belong in
the subject at all.

The subject is there to identify what the patch is about, what the patch
*is*, both for people who have seen it before and for people who have
not.  We need guidelines that encourage people to write good subjects
with that single goal in mind, and all other guidelines (or "rules") are
counterproductive.


Segher


More information about the Gcc-patches mailing list