contributing: tabs to spaces -- we get nice 4-char indentation

[obsolete/notmuch-wiki] / index.mdwn

diff --git a/index.mdwn b/index.mdwn
index da84bd018a83e7930079f2c721921593a7a39df7..6b719e33748aa99741fbe3931a3c2aead7109f79 100644 (file)
--- 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,
 
 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]]
   * [[General how-tos|howto]]

-  * [[Available frontends|frontends]]

   * [[Searching]]
   * [[Excluding and deleting messages|excluding]]
   * [[Initial tagging|Initial_Tagging]]
   * [[Searching]]
   * [[Excluding and deleting messages|excluding]]
   * [[Initial tagging|Initial_Tagging]]


@@ -64,8 +63,18 @@ docs:
   * [[Remote usage|remoteusage]]
   * [[Performance|performance]]
 
   * [[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:/vim/README),
+and a [[Mutt integration script|notmuch-mutt]].
+
+There are also many other [[email clients and frontends|frontends]] based on
+Notmuch.

 
 ## Screenshots
 
 
 ## Screenshots
 


@@ -74,6 +83,8 @@ list.  Read the archives.  Ask questions.
 ## Packages
 
 * [Debian](http://packages.debian.org/search?keywords=notmuch)
 ## Packages
 
 * [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/)
 * [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/)


@@ -89,41 +100,44 @@ versions can be checked out via git with this command:
 
         git clone git://notmuchmail.org/git/notmuch
 
 
         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.
+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.

 
 

-Source code of notmuch releases can be downloaded [here](http://notmuchmail.org/releases/).
+Here are
+[source tar balls of notmuch releases](http://notmuchmail.org/releases/).

 
 

-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
 
 Patches are most welcome and should be sent to notmuch@notmuchmail.org.
 Please try to follow the [[patch submission guidelines|patchformatting]]
 
 ## Bug-tracking and patches
 
 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.
+when submitting patches.

 
 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
 
 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]].
-
-The status of current patches can also be followed [[online|http://nmbug.tethera.net/status]].
+utility called [[nmbug]].  The status of current patches can also be
+followed [online](http://nmbug.tethera.net/status).

 
 ## Contact: Email & IRC
 
 Comments? Please feel free to email the notmuch mailing list:
 notmuch@notmuchmail.org (subscription is not required, but you can
 
 ## 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
 
 The `mb2md` utility can be used to convert the archives to maildir
 format which is convenient for reading the archives within notmuch


@@ -141,6 +155,5 @@ but it's a nice way to collect ideas.
 
 ## Website
 
 
 ## 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]].