[PATCH, v3] wwwdocs: e-mail subject lines for contributions

Richard Earnshaw (lists) Richard.Earnshaw@arm.com
Wed Jan 22 18:49:00 GMT 2020


[updated based on v2 discussions]

This patch proposes some new (additional) rules for email subject lines
when contributing to GCC.  The goal is to make sure that, as far as
possible, the subject for a patch will form a good summary when the
message is committed to the repository if applied with 'git am'.  Where
possible, I've tried to align these rules with those already in
use for glibc, so that the differences are minimal and only where
necessary.

Some things that differ from existing practice (at least by some people)
are:

- Use '<topic>:' rather than '[<topic>]'
   - This is more git friendly and works with 'git am'.
- Put bug numbers at the end of the line rather than the beginning.
   - The bug number is useful, but not as useful as the brief summary.
     Also, use the shortened form, as the topic part is more usefully
     conveyed in the proper topic field (see above).
-------------- next part --------------
A non-text attachment was scrubbed...
Name: contrib.patch
Type: text/x-patch
Size: 6900 bytes
Desc: not available
URL: <https://gcc.gnu.org/pipermail/gcc/attachments/20200122/dd95dca7/attachment.bin>


More information about the Gcc mailing list