git commit message conventions

Paul Eggert eggert@cs.ucla.edu
Wed Jun 3 03:08:00 GMT 2015


Joseph Myers wrote:
> I propose that we adopt standard git commit message conventions that: the
> first line of a commit message is a short description of the commit, the
> next line is a blank line, and the rest of the commit message is the
> detailed description / rationale for the patch

Many other GNU projects use this style, but with one further constraint: if you 
indent the entire commit message, and omit the 2nd (empty) line, the entire 
commit message must be a valid ChangeLog entry.  That way, there's a one-to-one 
relationship between commit messages and ChangeLog entries, and programs like 
vc-dwim can be used to generate commits.  Projects that use such a style include 
Coreutils, Gnulib, and GNU Emacs.  I suggest using it for glibc as well.



More information about the Libc-alpha mailing list