X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=INSTALL;h=e51b397cc2a9d77a56424074775dfcdaf4b5abfb;hp=c0b67a319642a41e2ec9b86009a60745cfe71598;hb=59b251ef940609dac7e17528065a39544463e0b4;hpb=aac1d6035238f6a2b18c0dc0d7a5190a2187c511 diff --git a/INSTALL b/INSTALL index c0b67a31..e51b397c 100644 --- a/INSTALL +++ b/INSTALL @@ -9,20 +9,14 @@ sequence of: make sudo make install -You can even skip the configure step if all of the dependencies of -Notmuch are satisfied. If they are not, the configure script will -notice that and provide instructions on where to obtain the necessary -dependencies. +In fact, if you don't plan to pass any arguments to the configure +script, then you can skip that step and just start with "make", (which +will call configure for you). See this command: -notmuch.el installation ------------------------ -Installing the notmuch.el emacs lisp function systemwide: + ./configure --help - sudo make install-emacs - -Each user needs to add (require 'notmuch) in his ~/.emacs to make it -available and then start emacs running notmuch with "emacs -f notmuch" -or start notmuch from within emacs with "M-x notmuch". +for detailed documentation of the things you can control at the +configure stage. Dependencies ------------ @@ -38,10 +32,12 @@ which are each described below: Xapian is available from http://xapian.org - After installing Xapian, please ensure that you have a command - named "xapian-config" on your $PATH as notmuch expects. (At - least one notmuch user found that Xapian installed the config - program to /usr/local/bin/xapian-config-1.1 ). + Note: Notmuch will work best with Xapian 1.0.18 (or later) or + Xapian 1.1.4 (or later). Previous versions of Xapian (whether + 1.0 or 1.1) had a performance bug that made notmuch very slow + when modifying tags. This would cause distracting pauses when + reading mail while notmuch would wait for Xapian when removing + the "inbox" and "unread" tags from messages in a thread. GMime 2.4 --------- @@ -64,16 +60,19 @@ which are each described below: Talloc is available from http://talloc.samba.org/ -On a modern, package-based operating system such as Debian, you can -install all of the dependencies with the following simple command -line: +On a modern, package-based operating system you can install all of the +dependencies with a simple simple command line. For example: + + For Debian and similar: sudo apt-get install libxapian-dev libgmime-2.4-dev libtalloc-dev -On other systems, a similar command can be used, but the details of -the package names may be different, (such as "devel" in place of -"dev"). + For Fedora and similar: + sudo yum install xapian-core-devel gmime-devel libtalloc-devel + +On other systems, a similar command can be used, but the details of +the package names may be different.