+[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
# Experimental Tag Sharing / Pseudo-Bug-Tracking for/with notmuch
## Web View
-There is a dump of (some views of) the nmbug [[status|http://nmbug.tethera.net/status]].
+There is a dump of (some views of) the nmbug [[status|http://nmbug.notmuchmail.org/status]].
## Getting started
-1. Install and use notmuch version **0.10** or newer and
- perl module `Pod::Usage` (packaged as `perl-doc` in debian).
+0. Make sure that the whole [notmuch@notmuchmail.org mailing list
+ archive][archive] is available in your email database.
- The nmbug script is available in `devel/nmbug`.
+1. Install and use nmbug from notmuch version **0.19** or newer, and
+ either Python 2.7 or anything from the 3.x line.
+
+ The nmbug script is available in [devel/nmbug][nmbug].
2. Make sure your `git version` is **1.7.4** or newer.
3. Enter the following command to obtain the current tag repository:
- `$ git clone --bare http://nmbug.tethera.net/git/nmbug-tags.git $HOME/.nmbug`
+ `$ nmbug clone http://nmbug.notmuchmail.org/git/nmbug-tags.git`
## Using nmbug, simple example
For the moment, we are using a central repo, hosted at:
- nmbug@nmbug.tethera.net:nmbug-tags
+ nmbug@nmbug.notmuchmail.org:nmbug-tags
To get push access, send your public key (ideally in a gpg signed
email) to David Bremner. There is a convenience command:
$ nmbug push
-But you will have to change your url with:
+But you will have to change your push URL with:
- $ git --git-dir=$HOME/.nmbug remote set-url origin nmbug@nmbug.tethera.net:nmbug-tags
+ $ git --git-dir=$HOME/.nmbug remote set-url --push origin nmbug@nmbug.notmuchmail.org:nmbug-tags
## Tagging conventions
You might or might not want as many exclusions. Another interesting
search is:
- tag:notmuch::reviewed and not tag:notmuch::pushed
+ tag:notmuch::patch and not tag:notmuch::needs-review and not \
+ tag:notmuch::pushed and not tag:notmuch::obsolete and not \
+ tag:notmuch::wontfix and not tag:notmuch::moreinfo and not \
+ tag:notmuch::stale and not tag:notmuch::wip
-See the [[status|http://nmbug.tethera.net/status]] page for more
+See the [[status|http://nmbug.notmuchmail.org/status]] page for more
example searches.
## Design notes
- Currently the parser of nmbug (like that of notmuch restore) assumes
that there are no spaces in message-ids.
+
+[archive]: http://notmuchmail.org/archives/notmuch.mbox
+[nmbug]: http://git.notmuchmail.org/git/notmuch/blob/HEAD:/devel/nmbug/nmbug