<p dir="ltr">I think we're agreeing more than not. I'll resend the docs change without hard numbers, as a guideline for people willing to do it right. </p>
<p dir="ltr">Cheers, <br>
Renato </p>
<div class="gmail_quote">On 8 Mar 2015 04:30, "Hal Finkel" <<a href="mailto:hfinkel@anl.gov">hfinkel@anl.gov</a>> wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">----- Original Message -----<br>
> From: "Reid Kleckner" <<a href="mailto:rnk@google.com">rnk@google.com</a>><br>
> To: "Renato Golin" <<a href="mailto:renato.golin@linaro.org">renato.golin@linaro.org</a>><br>
> Cc: "Hal Finkel" <<a href="mailto:hfinkel@anl.gov">hfinkel@anl.gov</a>>, "Clang Dev" <<a href="mailto:cfe-dev@cs.uiuc.edu">cfe-dev@cs.uiuc.edu</a>>, "LLVM Dev" <<a href="mailto:llvmdev@cs.uiuc.edu">llvmdev@cs.uiuc.edu</a>><br>
> Sent: Friday, March 6, 2015 2:59:54 PM<br>
> Subject: Re: [cfe-dev] [LLVMdev] Commit message policy?<br>
><br>
><br>
> I think the only guideline we should have is that the first line<br>
> should be written as though it is an email subject, because it gets<br>
> used for that. If you write a long first line, then you get a long<br>
> subject, and it looks silly. If people want to embarrass themselves<br>
> with strangely formatted email, they it's on them. We don't need a<br>
> specific hard or soft number.<br>
<br>
Indeed; I agree that this is the most important thing, and that we don't need a specific character count so long as we explain that it becomes the subject of an e-mail. What prompted me to ping this thread was yet-another private e-mail exchange I had with a relatively-new contributor, where I pointed this out, and he or she hadn't realized or thought about it, and asked if we had this advice anywhere on the web site.<br>
<br>
This part of the last-posted patch is also useful:<br>
<br>
+* `Attribution of Changes`_ should be in a separate line, after the end of<br>
+  the body, as simple as "Patch by John Doe.".<br>
<br>
because I find standardization in this area comforting (and, more importantly, it will remind people to do it).<br>
<br>
Thanks again,<br>
Hal<br>
<br>
><br>
><br>
> On Fri, Mar 6, 2015 at 11:56 AM, Renato Golin <<br>
> <a href="mailto:renato.golin@linaro.org">renato.golin@linaro.org</a> > wrote:<br>
><br>
><br>
> On 6 March 2015 at 18:33, Hal Finkel < <a href="mailto:hfinkel@anl.gov">hfinkel@anl.gov</a> > wrote:<br>
> > Hi Renato,<br>
> ><br>
> > Did anything ever happen with this?<br>
><br>
> Nope. People didn't want to commit to limits but still have a<br>
> guideline. I'm of the view that guidelines are meant to be ignored.<br>
><br>
> Do you want to continue pushing this?<br>
><br>
> cheers,<br>
> --renato<br>
><br>
><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>
><br>
><br>
<br>
--<br>
Hal Finkel<br>
Assistant Computational Scientist<br>
Leadership Computing Facility<br>
Argonne National Laboratory<br>
</blockquote></div>