Mesa (master): docs/submitting patches: add git tips

[Emil Velikov]

Module: Mesa
Branch: master
Commit: e260bfec04c7643649b88566460188fcafbb8356
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=e260bfec04c7643649b88566460188fcafbb8356

Author: Timothy Arceri <t_arceri at yahoo.com.au>
Date:   Mon Nov 21 16:30:12 2016 +0000

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 at yahoo.com.au>
Signed-off-by: Emil Velikov <emil.velikov at collabora.com>
Reviewed-by: Brian Paul <brianp at vmware.com> (v1)

---

 docs/submittingpatches.html | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/submittingpatches.html b/docs/submittingpatches.html
index d3e86f5..d2b605b 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 at 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>