X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=contributing.mdwn;h=e630cddad0b283abf9e4358d3e0a84b0e169c2fc;hb=acf314384388e1601754db3823b1b45191f9fa1e;hp=11d711bd061abf72aedca1281bd7ad64957bc7ee;hpb=09362e87f771dd37a5f04854499db0158c0c823c;p=notmuch-wiki diff --git a/contributing.mdwn b/contributing.mdwn index 11d711b..e630cdd 100644 --- a/contributing.mdwn +++ b/contributing.mdwn @@ -105,7 +105,7 @@ in the Notmuch source for further information. ## Update the documentation If you modify or add new features to the Notmuch command-line tools, -you should update the manual pages under the `man` directory of the +you should update the manual pages under the `doc` directory of the Notmuch source. If you modify or add new features to the Notmuch Emacs UI, you should @@ -116,6 +116,14 @@ update the Emacs documentation. If you make user visible changes, you should add an entry to the [`NEWS`](http://git.notmuchmail.org/git/notmuch/blob/HEAD:/NEWS) file. +## Update command-line completion + +If you modify or add new features to the Notmuch command-line tools, it +would be a nice bonus if you also updated the Notmuch command-line +completion scripts under the `completion` directory of the Notmuch +source. Not required, but nice to have, and definitely can be done +afterwards. + ## Subscribe to the Notmuch mailing list While strictly not required, it is advisable to subscribe to the @@ -182,14 +190,13 @@ have changed; be sure to rebase your updated changes on top of the current master. Once you have the updated series ready, send it to the mailing list -again. It will be helpful for others to use the -`--subject-prefix="PATCH vN"` option of `git format-patch` or -`git send-email` to add a version number of the patch series to the -subject (replacing vN with v2, v3, etc.) Use a cover letter (or, in -the case of a single patch, the notes after a "---" at the end of the -commit message) to summarize the main changes since the previous -version of the patch series. Also include the message-id reference of -the previous version. +again. It will be helpful for others to use the `-vN` option of `git +format-patch` or `git send-email` to add a version number of the patch +series to the subject (replacing vN with v2, v3, etc.) Use a cover +letter (or, in the case of a single patch, the notes after a "---" at +the end of the commit message) to summarize the main changes since the +previous version of the patch series. Also include the message-id +reference of the previous version. Using the `--in-reply-to` option of `git format-patch` or `git send-email` to send the patch series as a reply to the earlier