[PATCH] configure: add --without-api-docs option
[notmuch-archives.git] / 7d / cef4dce7a0569696fb5ef799249ebb58428814
1 Return-Path: <amdragon@mit.edu>\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 0593A429E26\r
6         for <notmuch@notmuchmail.org>; Sun, 11 Dec 2011 16:29:32 -0800 (PST)\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
8 X-Spam-Flag: NO\r
9 X-Spam-Score: -0.7\r
10 X-Spam-Level: \r
11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
12         tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
13 Received: from olra.theworths.org ([127.0.0.1])\r
14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
15         with ESMTP id nHOIAfXpUogn for <notmuch@notmuchmail.org>;\r
16         Sun, 11 Dec 2011 16:29:28 -0800 (PST)\r
17 Received: from dmz-mailsec-scanner-7.mit.edu (DMZ-MAILSEC-SCANNER-7.MIT.EDU\r
18         [18.7.68.36])\r
19         by olra.theworths.org (Postfix) with ESMTP id 8E8E0429E25\r
20         for <notmuch@notmuchmail.org>; Sun, 11 Dec 2011 16:29:28 -0800 (PST)\r
21 X-AuditID: 12074424-b7ef76d0000008dc-47-4ee54ae84533\r
22 Received: from mailhub-auth-4.mit.edu ( [18.7.62.39])\r
23         by dmz-mailsec-scanner-7.mit.edu (Symantec Messaging Gateway) with SMTP\r
24         id CA.B8.02268.8EA45EE4; Sun, 11 Dec 2011 19:29:28 -0500 (EST)\r
25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
26         by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id pBC0TRRH025152; \r
27         Sun, 11 Dec 2011 19:29:27 -0500\r
28 Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
29         (authenticated bits=0)\r
30         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
31         by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id pBC0TQVR010315\r
32         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
33         Sun, 11 Dec 2011 19:29:27 -0500 (EST)\r
34 Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77)\r
35         (envelope-from <amdragon@mit.edu>)\r
36         id 1RZtnL-0004ME-80; Sun, 11 Dec 2011 19:31:03 -0500\r
37 Date: Sun, 11 Dec 2011 19:31:03 -0500\r
38 From: Austin Clements <amdragon@MIT.EDU>\r
39 To: Jani Nikula <jani@nikula.org>\r
40 Subject: Re: [PATCH] emacs: support "notmuch new" as a notmuch-poll-script\r
41 Message-ID: <20111212003103.GI2760@mit.edu>\r
42 References: <1323640100-18326-1-git-send-email-jani@nikula.org>\r
43         <87wra26a5u.fsf@gmail.com> <20111211225822.GH2760@mit.edu>\r
44         <CAB+hUn-ADRtZRCq5Ad6H6R2L246EBR8hOSsk4B2yeRsH4kN16w@mail.gmail.com>\r
45 MIME-Version: 1.0\r
46 Content-Type: text/plain; charset=iso-8859-1\r
47 Content-Disposition: inline\r
48 Content-Transfer-Encoding: 8bit\r
49 In-Reply-To:\r
50  <CAB+hUn-ADRtZRCq5Ad6H6R2L246EBR8hOSsk4B2yeRsH4kN16w@mail.gmail.com>\r
51 User-Agent: Mutt/1.5.21 (2010-09-15)\r
52 X-Brightmail-Tracker:\r
53  H4sIAAAAAAAAA+NgFlrMKsWRmVeSWpSXmKPExsUixG6nrvvC66mfQftSVourW/vZLZqmO1tc\r
54         vzmT2YHZY+esu+wet+6/Zvd4tuoWcwBzFJdNSmpOZllqkb5dAlfGtDlvGAteilU0Xu1kbGCc\r
55         IdjFyMkhIWAicfX2aRYIW0ziwr31bF2MXBxCAvsYJTY+msUK4WxglGi8t4gdwjnJJHGm4RAT\r
56         SIuQwBJGia8PZEBsFgFVif+zP7OD2GwCGhLb9i9nBLFFBBQlNp/cD2RzcDALeEl8ny8JEhYG\r
57         Mje+7WYBCfMKaEtMnlwDMf4oo8Sbjc+ZQWp4BQQlTs58AnYds4COxM6td9ggxkhLLP/HARGW\r
58         l2jeOhusnFMgUOL6jKdgtqiAisSUk9vYJjAKz0IyaRaSSbMQJs1CMmkBI8sqRtmU3Crd3MTM\r
59         nOLUZN3i5MS8vNQiXXO93MwSvdSU0k2M4LhwUdnB2HxI6RCjAAejEg/vwfuP/YRYE8uKK3MP\r
60         MUpyMCmJ8j72fOonxJeUn1KZkVicEV9UmpNafIhRgoNZSYTX7u4TPyHelMTKqtSifJiUNAeL\r
61         kjhvw66HfkIC6YklqdmpqQWpRTBZGQ4OJQleZWD8CwkWpaanVqRl5pQgpJk4OEGG8wANDwWp\r
62         4S0uSMwtzkyHyJ9iVJQS51UESQiAJDJK8+B6YWnrFaM40CvCvF4gVTzAlAfX/QpoMBPQ4LgU\r
63         kKuLSxIRUlINjLsPKlnOV9j6sLD70vwr2U2MyU++fxX0vHH0uccudsY5DFy5uyf6hGS//3FL\r
64         fqtW89xzqlOVHdaKlp0t/7O3cOfGI+lnTn/tz1nhL6dwW1j+e1eXhXi8kvSjyA1n2Lbd0UxO\r
65         q8t+Mf20ske0yK9AA2//L447VWbkrl/OMMs5S+9AmPv0b/ou3EosxRmJhlrMRcWJAF42mE02        AwAA\r
66 Cc: notmuch@notmuchmail.org\r
67 X-BeenThere: notmuch@notmuchmail.org\r
68 X-Mailman-Version: 2.1.13\r
69 Precedence: list\r
70 List-Id: "Use and development of the notmuch mail system."\r
71         <notmuch.notmuchmail.org>\r
72 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
73         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
74 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
75 List-Post: <mailto:notmuch@notmuchmail.org>\r
76 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
77 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
78         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
79 X-List-Received-Date: Mon, 12 Dec 2011 00:29:32 -0000\r
80 \r
81 Quoth Jani Nikula on Dec 12 at  1:10 am:\r
82 >    On Dec 12, 2011 12:56 AM, "Austin Clements" <[1]amdragon@mit.edu> wrote:\r
83 >    >\r
84 >    > Quoth Dmitry Kurochkin on Dec 12 at  2:00 am:\r
85 >    > > Hi Jani.\r
86 >    > >\r
87 >    > > On Sun, 11 Dec 2011 23:48:20 +0200, Jani Nikula <[2]jani@nikula.org>\r
88 >    wrote:\r
89 >    > > > Let notmuch-poll-script be a function as well as a string. Make\r
90 >    default\r
91 >    > > > value nil instead of an empty string, but allow "" for backwards\r
92 >    > > > compatibility. Add a notmuch poll function to call "notmuch new"\r
93 >    using the\r
94 >    > > > configured notmuch-command.\r
95 >    > > >\r
96 >    > > > This allows taking better advantage of the "notmuch new" hooks from\r
97 >    emacs\r
98 >    > > > without intermediate scripts.\r
99 >    > > >\r
100 >    > >\r
101 >    > > I was just thinking about working on this myself :)\r
102 >    > >\r
103 >    > > I think a better solution would be to allow running a command with\r
104 >    > > arguments.  Creating a elisp function just to run a command with some\r
105 >    > > parameters feels wrong.  This way we would have to add another\r
106 >    function\r
107 >    > > each time we want to add another argument.\r
108 >    >\r
109 >    > This seems a little awkward to me, too, though perhaps it's the best\r
110 >    > way.  Other approaches to consider include accepting a list for\r
111 >    > notmuch-poll-script (e.g., ("notmuch" "new")) or leaving it as a\r
112 >    > string but treating it as a shell command so "notmuch new" would Just\r
113 >    > Work.  Personally, I think the latter is the most intuitive, but it\r
114 >    > would be worth looking at how other customizable external commands are\r
115 >    > done in Emacs.\r
116 >    >\r
117 >    > A function seems powerful, but also like overkill.  Can you give a use\r
118 >    > case for a function that wouldn't be more easily solved by one of the\r
119 >    > above approaches?\r
120\r
121 >    The only reason I had for using a function was running notmuch using\r
122 >    notmuch-command. Any ideas how to do that with the Just Works approach?\r
123 \r
124 Oh, I see.  I'd missed that.\r
125 \r
126 So here's another idea, prefaced with a rant.\r
127 \r
128 It's bothered me for a long time that notmuch-emacs didn't just know\r
129 by default how to check for new mail.  What MUA doesn't know how to\r
130 check for new mail?  Why does a new user of notmuch have to tell it\r
131 how to check for new mail?  Of course, this *had* to be configured\r
132 before because everyone had their own way of checking for new mail.\r
133 Hooks eliminate this unnecessary flexibility and make "notmuch new"\r
134 the one true way to check for new mail---as it ought to be---and in\r
135 turn make the notmuch-poll-script variable obsolete.\r
136 \r
137 So, what about changing the default "" setting of notmuch-poll-script\r
138 from meaning "do nothing and be useless" to meaning "run notmuch new\r
139 (using notmuch-command)"?  It will then automatically do the right\r
140 thing for new users, while still being backward-compatible and\r
141 allowing an escape hatch for bizarre situations.\r