<div dir="ltr">+1 for a having a short leading sentence followed by a blank line. This is always the email subject, so plan accordingly.<div><br></div><div>IMO the rest doesn't matter and isn't worth codifying.</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Sep 24, 2014 at 3:51 PM, Renato Golin <span dir="ltr"><<a href="mailto:renato.golin@linaro.org" target="_blank">renato.golin@linaro.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Folks,<br>
<br>
After looking at git / svn logs for a long time today, I realised that<br>
the commit messages could be a bit more helpful for that purpose<br>
(logs). The kernel has a good policy on commit messages, and I think<br>
we could use some of that, at least as a strong guideline, not as a<br>
hard rule.<br>
<br>
The idea, AFAIK, is to have a title with 50 chars, separated by an<br>
empty line and an infinite number of 80-col lines following. That<br>
allows us to be very descriptive on the context, but succinct enough<br>
on the title, so that logs can fit on a reasonably sized terminal +<br>
git ids, etc.<br>
<br>
Is that something we want to follow? I could only find the attribution<br>
rule on the developer's policy (which we should definitely keep), but<br>
would be good to have at least some policy on the commit message<br>
itself.<br>
<br>
Also, policies for messages when reverting patches, arc commits,<br>
approval lists would be good to have documented, rather than keep<br>
replying to people on the list.<br>
<br>
cheers,<br>
--renato<br>
<br>
PS: I don't want us to revert patches with non-standard messages, only<br>
encourage people to do it right.<br>
_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@cs.uiuc.edu">cfe-dev@cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev</a><br>
</blockquote></div><br></div>