f3/d2edead493dce66f80235f42a0a1727a999fa9

   1 Return-Path: <cworth@cworth.org>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 24500431FBF;\r
   6         Sun, 22 Nov 2009 17:37:53 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 Received: from olra.theworths.org ([127.0.0.1])\r
   9         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  10         with ESMTP id M6NabKg0TMJR; Sun, 22 Nov 2009 17:37:52 -0800 (PST)\r
  11 Received: from cworth.org (localhost [127.0.0.1])\r
  12         by olra.theworths.org (Postfix) with ESMTP id B67BB431FAE;\r
  13         Sun, 22 Nov 2009 17:37:51 -0800 (PST)\r
  14 From: Carl Worth <cworth@cworth.org>\r
  15 To: Jjgod Jiang <gzjjgod@gmail.com>, notmuch@notmuchmail.org\r
  16 In-Reply-To: <ddd65cda0911212044k7501a763sb454be337f72756b@mail.gmail.com>\r
  17 References: <ddd65cda0911212044k7501a763sb454be337f72756b@mail.gmail.com>\r
  18 Date: Mon, 23 Nov 2009 02:37:37 +0100\r
  19 Message-ID: <87aayeggwu.fsf@yoom.home.cworth.org>\r
  20 MIME-Version: 1.0\r
  21 Content-Type: text/plain; charset=us-ascii\r
  22 Subject: Re: [notmuch] Guide for new users?\r
  23 X-BeenThere: notmuch@notmuchmail.org\r
  24 X-Mailman-Version: 2.1.12\r
  25 Precedence: list\r
  26 List-Id: "Use and development of the notmuch mail system."\r
  27         <notmuch.notmuchmail.org>\r
  28 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  29         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  30 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  31 List-Post: <mailto:notmuch@notmuchmail.org>\r
  32 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  33 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  34         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  35 X-List-Received-Date: Mon, 23 Nov 2009 01:37:53 -0000\r
  36 \r
  37 On Sun, 22 Nov 2009 12:44:17 +0800, Jjgod Jiang <gzjjgod@gmail.com> wrote:\r
  38 > I think it will be nice if we can have a guide/tutorial like\r
  39 > documentation for new users. For myself, I have the following\r
  40 > questions (I am an alpine user previously, so some of the\r
  41 > questions are not related to notmuch directly):\r
  42 \r
  43 Hi Jiang, welcome to notmuch!\r
  44 \r
  45 There's definitely a lot more documentation we could use. I think one of\r
  46 the things I'd like to know is, where did you look when you wanted\r
  47 answers to these questions? That can help us know where the best places\r
  48 are to put some answers.\r
  49 \r
  50 As for getting started with notmuch itself, I've tried to make it fairly\r
  51 self-guided. (That is, if you just run "notmuch"[*] it should keep\r
  52 telling you what to do next.) I'd be very interested in getting feedback\r
  53 from people on how well this works. Did you run it that way? Were its\r
  54 suggestions helpful?\r
  55 \r
  56 [*] The assumption being that people will try to run the program before\r
  57 reading any documentation.\r
  58 \r
  59 > 1. What's the most efficient way to sync mails from my gmail\r
  60 > account to a local Maildir? I've tried offlineimap but it\r
  61 > keeps crashing python (!) on my system (python 2.6, Mac OS X\r
  62 > 10.6.2).\r
  63 \r
  64 One of the big tricks with switching to notmuch is that there's so much\r
  65 that notmuch doesn't do. If one is coming from a monolithic email\r
  66 program (such as evolution) or webmail (such as gmail) then notmuch only\r
  67 replaces a tiny piece of the mail program, (search and tagging).\r
  68 \r
  69 But the user also needs replacements for all of the other pieces of the\r
  70 mail program. Such as:\r
  71 \r
  72   * Receiving mail\r
  73 \r
  74   * Composing mail (with a nice address book)\r
  75 \r
  76   * Sending mail\r
  77 \r
  78 And likely other stuff I'm not thinking of right now. So those things\r
  79 can involve lots of different programs. For receiving it might be\r
  80 offlineimap, getmail, fetchmail, procmail, maildrop or some\r
  81 combination. For composing it could be emacs, vim, etc. And sending mail\r
  82 might involve msmtp, postfix, or exim4, etc.\r
  83 \r
  84 That's a long list of packages, and likely an overwhelming set of\r
  85 possibilities as well as a ton to learn for setting these up and\r
  86 configuring them.\r
  87 \r
  88 So I think you're right that we're going to want some guide suggesting\r
  89 best practicing for setting things like this up.\r
  90 \r
  91 > 2. How to add notmuch.el into my .emacsrc?\r
  92 \r
  93 We've at least added this much to INSTALL now. First do:\r
  94 \r
  95         sudo make install-emacs\r
  96 \r
  97 Then in your .emacs add:\r
  98 \r
  99         (require 'notmuch)\r
 100 \r
 101 And then you can run "M-x notmuch".     \r
 102 \r
 103 > I know notmuch feels like a tool for geeks, but it will probably\r
 104 > lower the barrier if someone can provide such a guide in a\r
 105 > straightforward, step-by-step way.\r
 106 \r
 107 A "tool for geeks" means that it works well and efficiently, (without\r
 108 "fluff" or mis-features). It doesn't mean that it needs to be hard to\r
 109 learn, or require specialized knowledge in advance before using it.\r
 110 \r
 111 So yes, I totally agree that we need to document things like this\r
 112 better, and make it as easy to start using notmuch as possible.\r
 113 \r
 114 -Carl\r