X-Git-Url: https://git.cworth.org/git?p=obsolete%2Fnotmuch-wiki;a=blobdiff_plain;f=index.mdwn;h=d00789b9f37cca3e10a27cd3bb7181405372b3c7;hp=553eae5ca345711a938a8fc6c225115e7e7654c2;hb=db0ad04e394b48a6e65fff7ce71ed8ab06012bd6;hpb=324a3a00d170bd83bd5f598d180275075ffad2e5 diff --git a/index.mdwn b/index.mdwn index 553eae5..d00789b 100644 --- a/index.mdwn +++ b/index.mdwn @@ -51,12 +51,11 @@ looking for. To get started with notmuch, just run "notmuch" at the command line. The configuration wizard will walk you through initial setup, -including specifying the location of your mail store and now to start -the initial indexing. After that, come back and checkout how our -docs: +including specifying the location of your mail store and how to start +the initial indexing. After that, come back and checkout our docs: + * [[Notmuch manual pages|manpages]] * [[General how-tos|howto]] - * [[Available frontends|frontends]] * [[Searching]] * [[Excluding and deleting messages|excluding]] * [[Initial tagging|Initial_Tagging]] @@ -64,21 +63,39 @@ docs: * [[Remote usage|remoteusage]] * [[Performance|performance]] -Apart from the wiki, help is available via email. Join the mailing -list. Read the archives. Ask questions. +Apart from the wiki, help is available via email and on IRC (see +below). Join the mailing list. Read the archives. Ask questions. + +## Email clients and front ends + +Notmuch ships with a powerful set of [[command-line tools|manpages]], an +[[email client for Emacs|emacstips]], another +[client for vim](http://git.notmuchmail.org/git/notmuch/blob/HEAD:/contrib/notmuch-vim/README), +and a [[Mutt integration script|notmuch-mutt]]. + +There are also many other [[email clients and frontends|frontends]] based on +Notmuch. ## Screenshots * [[Emacs UI screenshots|screenshots]] -## Packages +## Obtaining Notmuch -* [Debian](http://packages.debian.org/search?keywords=notmuch), [Ubuntu](http://packages.ubuntu.com/search?keywords=notmuch) -* [Slackware](http://slackbuilds.org/repository/13.37/office/notmuch/) +[Notmuch source releases](http://notmuchmail.org/releases/) are available as +source tar balls. + +Notmuch is packaged for the following distributions: + +* [Debian](http://packages.debian.org/search?keywords=notmuch) (Please use at + least the packages from squeeze-backports, squeeze packages are very + outdated!) * [Fedora](https://community.dev.fedoraproject.org/packages/notmuch) * [Gentoo](http://packages.gentoo.org/package/net-mail/notmuch) +* [Slackware](http://slackbuilds.org/repository/13.37/office/notmuch/) +* [Ubuntu](http://packages.ubuntu.com/search?keywords=notmuch) -## Source code +## Development and Contributing All of the code for Notmuch is available as [free software](http://www.fsf.org/licensing/essays/free-sw.html) released @@ -88,41 +105,42 @@ versions can be checked out via git with this command: git clone git://notmuchmail.org/git/notmuch -You can browse the [Notmuch code -history](http://git.notmuchmail.org/git/notmuch) online. And finally, -you can [subscribe to the `notmuch-commits` -list](http://notmuchmail.org/mailman/listinfo/notmuch-commits) to watch -every commit made to notmuch and the notmuchmail.org web site. - -Source code of notmuch releases can be downloaded [here](http://notmuchmail.org/releases/). +You can browse the +[Notmuch code history online](http://git.notmuchmail.org/git/notmuch). And +finally, you can +[subscribe to the `notmuch-commits` list](http://notmuchmail.org/mailman/listinfo/notmuch-commits) +to watch every commit made to notmuch and the notmuchmail.org web +site. -There is a buildbot [here](http://buildbot.notmuchmail.org/grid) (configuration [here](https://github.com/tomprince/buildbot-configs/tree/notmuch)). +We have a [buildbot](http://buildbot.notmuchmail.org/grid) (here's +its +[configuration](https://github.com/tomprince/buildbot-configs/tree/notmuch)). -## Bug-tracking and patches +Contributions, such as patches, to Notmuch are most welcome. Please refer to the +[[guide to contributing|contributing]]. -Patches are most welcome and should be sent to notmuch@notmuchmail.org. -Please try to follow the [[patch submission guidelines|patchformatting]] -when submitting patches to notmuch. +## Bug and patch tracking The tagging and filtering features of notmuch make it quite suitable for use as a bug- and patch-tracker. We are currently experimenting with using it for this purpose for notmuch development, using a -utility called [[nmbug]]. +utility called [[nmbug]]. The status of bugs and current patches can also be +followed [online](http://nmbug.tethera.net/status). -The status of current patches can also be followed [[online|http://nmbug.tethera.net/status]]. +Bug reports should be sent to the Notmuch mailing list notmuch@notmuchmail.org. ## Contact: Email & IRC Comments? Please feel free to email the notmuch mailing list: notmuch@notmuchmail.org (subscription is not required, but you can -subscribe to the [notmuch -list](http://notmuchmail.org/mailman/listinfo/notmuch) if you would -like to). You can also browse the [online -archives](http://notmuchmail.org/pipermail/notmuch/) of the mailing -list, read them as a [web forum -(nabble)](http://notmuch.198994.n3.nabble.com/), or download an -[mbox file](http://notmuchmail.org/archives/notmuch.mbox) of the entire -mailing-list. +also subscribe to the +[notmuch mailing list](http://notmuchmail.org/mailman/listinfo/notmuch)). You +can also browse the +[online list archives](http://notmuchmail.org/pipermail/notmuch/), +read them as a +[web forum (nabble)](http://notmuch.198994.n3.nabble.com/), or +download an [mbox file](http://notmuchmail.org/archives/notmuch.mbox) +of the entire mailing-list. The `mb2md` utility can be used to convert the archives to maildir format which is convenient for reading the archives within notmuch @@ -134,12 +152,12 @@ channel. ## Feature ideas -We have started a [[feature requests|feature-requests]] page on this -wiki. No, things you add there won't automatically get implemented - -but it's a nice way to collect ideas. +If you have a feature idea/request, please send it to the +[mailing list](http://notmuchmail.org/mailman/listinfo/notmuch). You +don't have to be subscribed to send, although there might be a delay +for non-subscribers. ## Website -This wiki is maintained using -[ikiwiki](http://ikiwiki.info). Instructions on how to edit it can be -found [[here|wikiwriteaccess]]. +This wiki is maintained using [ikiwiki](http://ikiwiki.info). Here are +[[instructions on how to edit the wiki|wikiwriteaccess]].