From: Timothy Arceri <t_arceri@yahoo.com.au>
Date: Mon, 21 Nov 2016 16:30:12 +0000 (+0000)
Subject: docs/submitting patches: add git tips
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=e260bfec04c7643649b88566460188fcafbb8356;p=mesa.git

docs/submitting patches: add git tips

v2: [Emil Velikov]
 - Add the shorthand git send-email -vX
 - Move to submittingpatches.html
 - Add to the TOC.

v3: [Emil Velikov]
 - Use @~8 instead of HEAD~8 (Nicolai)

Cc: Timothy Arceri <t_arceri@yahoo.com.au>
Signed-off-by: Emil Velikov <emil.velikov@collabora.com>
Reviewed-by: Brian Paul <brianp@vmware.com> (v1)
---

diff --git a/docs/submittingpatches.html b/docs/submittingpatches.html
index d3e86f5b443..d2b605bf878 100644
--- a/docs/submittingpatches.html
+++ b/docs/submittingpatches.html
@@ -25,6 +25,7 @@
 <li><a href="#reviewing">Reviewing Patches</a>
 <li><a href="#nominations">Nominating a commit for a stable branch</a>
 <li><a href="#criteria">Criteria for accepting patches to the stable branch</a>
+<li><a href="#gittips">Git tips</a>
 </ul>
 
 <h2 id="guidelines">Basic guidelines</h2>
@@ -317,6 +318,25 @@ be rejected:
   regression that is unaacceptable for the stable branch.</li>
 </ul>
 
+<h2 id="gittips">Git tips</h2>
+
+<ul>
+<li>Test for build breakage between patches e.g last 8 commits.
+<pre>
+    git rebase -i --exec="make -j4" HEAD~8
+</pre>
+<li>Sets the default mailing address for your repo.
+<pre>
+    git config --local sendemail.to mesa-dev@lists.freedesktop.org
+</pre>
+<li> Add version to subject line of patch series in this case for the last 8
+commits before sending.
+<pre>
+    git send-email --subject-prefix="PATCH v4" HEAD~8
+    git send-email -v4 @~8 # shorter version, inherited from git format-patch
+</pre>
+</ul>
+
 
 </div>
 </body>