[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Referring to revisions in the git future.

From: Stefan Monnier
Subject: Re: Referring to revisions in the git future.
Date: Wed, 29 Oct 2014 09:59:13 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux)

>> About summary lines, a reminder: Please don't write the traditional
>> GNUish run-on change comment with a semi-infinite number of bulleted
>> items in it any more.
>     That's your opinion, but the convention we still use here (and don't
>     just recommend but *request* people to follow) is the GNU ChangeLog
>     format.
> You can have both.  In other GNU projects using git (gdb, binutils) we
> include a summary line for the benefit of `git log --oneline', followed
> by an extended description in a separated paragraph(s) and finally the
> ChangeLog entries.

We do like to have a summary line as well, indeed (that's part of the
reason why 24.4 has now "Summary:" in the default content of the
*VC-Log* buffer where you write your commit message).  But Eric was
recommending not to include the full ChangeLog thingy.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]