[LLVMdev] [cfe-dev] Commit message policy?

[Reid Kleckner]

+1 for a having a short leading sentence followed by a blank line. This is
always the email subject, so plan accordingly.

IMO the rest doesn't matter and isn't worth codifying.

On Wed, Sep 24, 2014 at 3:51 PM, Renato Golin <renato.golin at linaro.org>
wrote:

> Folks,
>
> After looking at git / svn logs for a long time today, I realised that
> the commit messages could be a bit more helpful for that purpose
> (logs). The kernel has a good policy on commit messages, and I think
> we could use some of that, at least as a strong guideline, not as a
> hard rule.
>
> The idea, AFAIK, is to have a title with 50 chars, separated by an
> empty line and an infinite number of 80-col lines following. That
> allows us to be very descriptive on the context, but succinct enough
> on the title, so that logs can fit on a reasonably sized terminal +
> git ids, etc.
>
> Is that something we want to follow? I could only find the attribution
> rule on the developer's policy (which we should definitely keep), but
> would be good to have at least some policy on the commit message
> itself.
>
> Also, policies for messages when reverting patches, arc commits,
> approval lists would be good to have documented, rather than keep
> replying to people on the list.
>
> cheers,
> --renato
>
> PS: I don't want us to revert patches with non-standard messages, only
> encourage people to do it right.
> _______________________________________________
> cfe-dev mailing list
> cfe-dev at cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20140924/7e84e9ad/attachment.html>