[PATCH] configure: add --without-api-docs option
[notmuch-archives.git] / 5d / 140810d04a3cadeb0e4685b14c6ac618fc3501
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 A672C429E36\r
6         for <notmuch@notmuchmail.org>; Thu, 12 Jan 2012 09:28:40 -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 q5ymqneYazP4 for <notmuch@notmuchmail.org>;\r
16         Thu, 12 Jan 2012 09:28:40 -0800 (PST)\r
17 Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU\r
18         [18.9.25.12])\r
19         by olra.theworths.org (Postfix) with ESMTP id D1F58431FB6\r
20         for <notmuch@notmuchmail.org>; Thu, 12 Jan 2012 09:28:39 -0800 (PST)\r
21 X-AuditID: 1209190c-b7fad6d000000920-94-4f0f18479d6f\r
22 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35])\r
23         by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP\r
24         id 9B.1D.02336.7481F0F4; Thu, 12 Jan 2012 12:28:39 -0500 (EST)\r
25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
26         by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id q0CHSceN001908; \r
27         Thu, 12 Jan 2012 12:28:39 -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 q0CHSb3v009914\r
32         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
33         Thu, 12 Jan 2012 12:28:38 -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 1RlOS8-0006F8-Py; Thu, 12 Jan 2012 12:28:40 -0500\r
37 Date: Thu, 12 Jan 2012 12:28:40 -0500\r
38 From: Austin Clements <amdragon@MIT.EDU>\r
39 To: Pieter Praet <pieter@praet.org>\r
40 Subject: Re: [PATCH] Output unmodified Content-Type header value for JSON\r
41         format.\r
42 Message-ID: <20120112172840.GC18625@mit.edu>\r
43 References: <1321659905-24367-1-git-send-email-dmitry.kurochkin@gmail.com>\r
44         <87fwhkyisj.fsf@servo.finestructure.net> <87wrawq1dz.fsf@gmail.com>\r
45         <87d3coxu7s.fsf@servo.finestructure.net> <87r512pru2.fsf@gmail.com>\r
46         <87ipmewo4z.fsf@servo.finestructure.net>\r
47         <20111123034021.GL9351@mit.edu> <87ipkglui4.fsf@praet.org>\r
48 MIME-Version: 1.0\r
49 Content-Type: text/plain; charset=us-ascii\r
50 Content-Disposition: inline\r
51 In-Reply-To: <87ipkglui4.fsf@praet.org>\r
52 User-Agent: Mutt/1.5.21 (2010-09-15)\r
53 X-Brightmail-Tracker:\r
54  H4sIAAAAAAAAA+NgFprOKsWRmVeSWpSXmKPExsUixCmqrOsuwe9vsPKFlMWefV4W12/OZLb4\r
55         /foGswOzx93TXB7PVt1i9ujYd5k1gDmKyyYlNSezLLVI3y6BK+PEmxNsBUcEK87s38HewNjD\r
56         18XIySEhYCIx6ekTJghbTOLCvfVsXYxcHEIC+xglfk6ewQ7hbGCUaJjezwThnGSSWLb6HwuE\r
57         s4RR4sXhFcxdjBwcLAKqEi3LqkBGsQloSGzbv5wRxBYRUJY4/eQnO4jNLBAhMWXGR7B1wgLB\r
58         Ei+XtYPZvAI6EgfmHmMFsYUEjjBJXJhZDBEXlDg58wkLRK+WxI1/L5lAVjELSEss/8cBEuYU\r
59         UJd4tGwJWKuogIrElJPb2CYwCs1C0j0LSfcshO4FjMyrGGVTcqt0cxMzc4pTk3WLkxPz8lKL\r
60         dA31cjNL9FJTSjcxgsNckmcH45uDSocYBTgYlXh4Xwnz+wuxJpYVV+YeYpTkYFIS5c0XAwrx\r
61         JeWnVGYkFmfEF5XmpBYfYpTgYFYS4Z18ns9fiDclsbIqtSgfJiXNwaIkzqui9c5PSCA9sSQ1\r
62         OzW1ILUIJivDwaEkwTtPHGioYFFqempFWmZOCUKaiYMTZDgP0PCjIDW8xQWJucWZ6RD5U4y6\r
63         HCfXXjnHKMSSl5+XKiXOuxekSACkKKM0D24OLD29YhQHekuYdw5IFQ8wtcFNegW0hAloSVkK\r
64         yAfFJYkIKakGxvpDU7dMFfxxSVJo/U4/tVWvn8YGbfWovFjv0W6aXTG5K2b2kq+uky+5Pt5R\r
65         fMLiu5TrwuUZh1wfNyhG2OU+ur2zZMGSvgeip3WtUmTsl21P/LCSyaeiXHntau8Ak+9L7O4f\r
66         kdLqffuowmhuoWWUfH/xCo21Xy48fBr562oC2523LK8O5xq9eKPEUpyRaKjFXFScCACbddDL\r
67         KgMAAA==\r
68 Cc: notmuch@notmuchmail.org\r
69 X-BeenThere: notmuch@notmuchmail.org\r
70 X-Mailman-Version: 2.1.13\r
71 Precedence: list\r
72 List-Id: "Use and development of the notmuch mail system."\r
73         <notmuch.notmuchmail.org>\r
74 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
75         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
76 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
77 List-Post: <mailto:notmuch@notmuchmail.org>\r
78 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
79 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
80         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
81 X-List-Received-Date: Thu, 12 Jan 2012 17:28:40 -0000\r
82 \r
83 Quoth Pieter Praet on Jan 12 at  6:07 pm:\r
84 > On Tue, 22 Nov 2011 22:40:21 -0500, Austin Clements <amdragon@MIT.EDU> wrote:\r
85 > > Quoth Jameson Graef Rollins on Nov 20 at 12:10 pm:\r
86 > > > The open question seems to be how we handle the content encoding\r
87 > > > parameters.  My argument is that those should either be used by notmuch\r
88 > > > to properly encode the content for the consumer.  If that's not\r
89 > > > possible, then just those parameters needed by the consumer to decode\r
90 > > > the content should be output.\r
91 > > \r
92 > > If notmuch is going to include part content in the JSON output (which\r
93 > > perhaps it shouldn't, as per recent IRC discussions), then it must\r
94 > > handle content encodings because JSON must be Unicode and therefore\r
95 > > the content strings in the JSON must be Unicode.\r
96\r
97 > Having missed the IRC discussions: what is the rationale for not\r
98 > including (specific types of?) part content in the JSON output ?\r
99 > Eg. how about inline attached text/x-patch ?\r
100 \r
101 Technically the IRC discussion was about not including *any* part\r
102 content in the JSON output, and always using show --format=raw or\r
103 similar to retrieve desired parts.  Currently, notmuch includes part\r
104 content in the JSON only for text/*, *except* when it's text/html.  I\r
105 assume non-text parts are omitted because binary data is hard to\r
106 represent in JSON and text/html is omitted because some people don't\r
107 need it.  However, this leads to some peculiar asymmetry in the Emacs\r
108 code where sometimes it pulls part content out of the JSON and\r
109 sometimes it retrieves it using show --format=raw.  This in turn leads\r
110 to asymmetry in content encoding handling, since notmuch handles\r
111 content encoding for parts included in the JSON (and there's no good\r
112 way around that since JSON is Unicode), but not for parts retrieved as\r
113 raw.\r
114 \r
115 The idea discussed on IRC was to remove all part content from the JSON\r
116 output and to always use show to retrieve it, possibly beefing up\r
117 show's support for content decoding (and possibly introducing a way to\r
118 retrieve multiple raw parts at once to avoid re-parsing).  This would\r
119 get the JSON format out of the business of guessing what consumers\r
120 need, simplify the Emacs code, and normalize content encoding\r
121 handling.\r