Update news & manpages to notmuch version 0.16

[obsolete/notmuch-wiki] / patchformatting.mdwn

diff --git a/patchformatting.mdwn b/patchformatting.mdwn
index 73f7b10be4e12fe16c245ee020aacfd1ba7f1999..ed15b9f83bf1457ca0cbaf96bb81832061c370a4 100644 (file)
--- a/patchformatting.mdwn
+++ b/patchformatting.mdwn
@@ -12,6 +12,8 @@ you should check the following:
 
 3. Get familiar with coding conventions used.
 
+4. Read `devel/STYLE` in notmuch source.
+
 This way you get some insight of the look and feel of the patches sent,
 both the way code should be written, how to write commit log messages
 and how to participate patch discussions.
@@ -25,10 +27,10 @@ working tree will follow.
 
 Enter your commit message in following format:
 
-      first commit line; short one line description
+        first commit line; short one line description
       
-      After one empty line, a detailed description of your changes
-      the description most usually spans over multiple lines.
+        After one empty line, a detailed description of your changes
+        the description most usually spans over multiple lines.
 
 Wrap the lines to about __72__ characters or so. On an 80 column terminal,
 if we subtract 4 columns for the indent on the left and 4 more for
@@ -83,33 +85,33 @@ that your patch achieves what it is meant it to.
 If you've made just one commit (containing just one bugfix or new feature)
 you can run
 
-      git format-patch HEAD^
+        git format-patch HEAD^
 
 This outputs something like
 
-      0001-one-line-description.patch
+        0001-one-line-description.patch
 
 This is the file name of your patch with content:
 
-      From <-40-character-sha1-hexadecimal-string-> Day Mon DD HH:MM:SS YYYY
-      From: user.name <user.email>
-      Date: Day, DD Mon YYYY HH:MM:SS TZOFF
-      Subject: [PATCH] first commit line; one line description, up to 65 chars
+        From <-40-character-sha1-hexadecimal-string-> Day Mon DD HH:MM:SS YYYY
+        From: user.name <user.email>
+        Date: Day, DD Mon YYYY HH:MM:SS TZOFF
+        Subject: [PATCH] first commit line; one line description, up to 72 chars
 
-      after one empty line, a detailed description of your patch
-      the description most usually spans over multiple lines.
-      ---
-       <diffstat lines>
-       nn files changed, nn insertions(+) nn deletions(-)
+        after one empty line, a detailed description of your patch
+        the description most usually spans over multiple lines.
+        ---
+         <diffstat lines>
+         nn files changed, nn insertions(+) nn deletions(-)
 
-      diff --git a/<1st filename> b/<1st filename>
-      ...
+        diff --git a/<1st filename> b/<1st filename>
+        ...
 
 If you have committed more patches, and want to prepare all of those
 you can check with `git log` a 40-char commit-sha1 of the last commit
 *since* you want to generate patch files. When you enter 
 
-      git format-patch <commit-sha1(-prefix)>
+        git format-patch <commit-sha1(-prefix)>
 
 every commit *after* that commit-sha1 will be used to generate 
 patch files...
@@ -128,23 +130,22 @@ test-apply your patch files on origin/master:
 
 * Simple case -- no other changes on top of origin/master
 
-       git reset --hard origin/master
-        git pull
-       git am 00*
+            git reset --hard origin/master
+            git pull
+            git am 00*
 
 * A case where working tree is dirty
 
-       git log -1 --format=%H > head_commit
-       git stash save
-       git reset --hard origin/master
-        git pull
-       git am 00*
-       
-       git reset --hard `cat head_commit`
-       git stash apply
-       rm head_commit
-       git stash drop
-       
+            git log -1 --format=%H > head_commit
+            git stash save
+            git reset --hard origin/master
+            git pull
+            git am 00*
+            :
+            git reset --hard `cat head_commit`
+            git stash apply
+            rm head_commit
+            git stash drop
 
 ## Sending patches
 
@@ -154,7 +155,7 @@ test-apply your patch files on origin/master:
 
 If you try to execute `git send-email` and you get
 
-      git: 'send-email' is not a git command. See 'git --help'.
+        git: 'send-email' is not a git command. See 'git --help'.
 
 Then you're using git installation where send-email command is distributed
 in separate package. In Debian/Ububtu/RedHat/Fedora the package is named
@@ -168,7 +169,7 @@ work properly). Check through `git-send-email` manual page and play with it.
 
 In case of one-file you might want to use
 
-      git send-email --annotate 0001-* 
+        git send-email --annotate 0001-* 
 
 (other options omitted) to add a 'discussion' part into your
 email. The `git am` tool which is eventually used to submit the patch