<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On 4 February 2014 01:47, Manuel Klimek <span dir="ltr"><<a href="mailto:klimek@google.com" target="_blank">klimek@google.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div class="im">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">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><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></div></blockquote><div><br></div><div>OK, I've changed the wording.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra">
<div class="gmail_quote"><div class="im"><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><div>It might be a good idea to add that using arcanist to submit the patches will automatically add those comments?</div></div>
</div></div></blockquote><div><br></div><div>OK, done.  I suspected Arcanist might do that, but I haven't tried using it yet.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">
<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></div></div></blockquote><div><br></div><div>Can there be any objection to linking to the code review from a commit message?  Chromium changes have similar review links, and it's very useful for getting more information about a change.</div>
<div><br></div><div>Cheers,</div><div>Mark</div><div><br></div></div></div></div>