<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Mon, Feb 3, 2014 at 10:20 PM, Mark Seaborn <span dir="ltr"><<a href="mailto:mseaborn@chromium.org" target="_blank">mseaborn@chromium.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi chandlerc, klimek,<br>
<br>
Add a note about using "Differential Revision:" in commit messages<br>
<br>
I noticed this convention from the commit logs.  It seems like it<br>
would be useful to document it, to encourage other committers to link<br>
back to code reviews in their commits.<br>
<br>
<br>
<a href="http://llvm-reviews.chandlerc.com/D2678" target="_blank">http://llvm-reviews.chandlerc.com/D2678</a><br>
<br>
Files:<br>
  docs/Phabricator.rst<br>
<br>
Index: docs/Phabricator.rst<br>
===================================================================<br>
--- docs/Phabricator.rst<br>
+++ docs/Phabricator.rst<br>
@@ -94,6 +94,22 @@<br>
 the web interface. Thus, please type LGTM into the comment box to accept<br>
 a change from Phabricator.<br>
<br>
+Committing a change<br>
+-------------------<br>
+<br>
+When committing an LLVM change, the commit message should end with the line:<br></blockquote><div><br></div><div>I think this is worded way too strongly - phab is by no way mandatory.</div><div>Perhaps:<br>When committing an LLVM change that has been reviewed via phabricator, submit messages may end with the line:</div>
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
+<br>
+::<br>
+<br>
+  Differential Revision: <URL><br>
+<br>
+where ``<URL>`` is the URL for the code review, starting with<br>
+``<a href="http://llvm-reviews.chandlerc.com/``" target="_blank">http://llvm-reviews.chandlerc.com/``</a>.<br>
+<br>
+This allows people reading the version history to see the review for<br>
+context.  This also allows Phabricator to detect the commit, close the<br>
+review, and add a link from the review to the commit.<br></blockquote><div><br></div><div>It might be a good idea to add that using arcanist to submit the patches will automatically add those comments?</div><div><br></div>
<div>I'm also not sure whether people who are less in favor of phabricator (I know there are quite a few) are actually fine with that. I'd like to hear some more supportive feedback before encouraging this...</div>
<div><br></div><div>Thanks!</div><div>/Manuel</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
+<br>
 Status<br>
 ------<br>
</blockquote></div><br></div></div>