5e/e1cfb3f6008322a67893d0de320af65dba39f5

   1 Return-Path: <jani@nikula.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 2ABC8431FD0\r
   6         for <notmuch@notmuchmail.org>; Sat, 30 Nov 2013 13:40:41 -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 X0YicW9kGndd for <notmuch@notmuchmail.org>;\r
  16         Sat, 30 Nov 2013 13:40:35 -0800 (PST)\r
  17 Received: from mail-ea0-f169.google.com (mail-ea0-f169.google.com\r
  18         [209.85.215.169]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id BCBEB431FAF\r
  21         for <notmuch@notmuchmail.org>; Sat, 30 Nov 2013 13:40:34 -0800 (PST)\r
  22 Received: by mail-ea0-f169.google.com with SMTP id l9so7956002eaj.28\r
  23         for <notmuch@notmuchmail.org>; Sat, 30 Nov 2013 13:40:29 -0800 (PST)\r
  24 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  25         d=1e100.net; s=20130820;\r
  26         h=x-gm-message-state:from:to:subject:in-reply-to:references\r
  27         :user-agent:date:message-id:mime-version:content-type;\r
  28         bh=kv055V59BnGuoAzTnFGPpGAJUQPoRdzF0O7nmIgCFv0=;\r
  29         b=C0t7BL8a9J283McIR2zuSuBWiEP6Deh8eqGgQymW/O5+rbXaM4wOgmeTAxn/GkbHa5\r
  30         OTfHhNZjkp1XsmTcP+aT5fos4cIe83ftc8QjrSogdKelQ8IEMyA3ZwGafD+9M8FCqPWn\r
  31         XufmtCoL7xkP4K0LgclqMYQ/DC1m6J3I9GnRPZAsXo42yd6xK0eBfV1NRnP15wx5enyv\r
  32         NlZAK5tnvCtfReOvv/xEXy1COi7IbqkFc3T9ZJpsNfMM/GWOuZKwnspOwupwHlaoOQQC\r
  33         SmXcuecnsb/7eBBUODH3eTN7u0VvZ0sNfIutKPnfS7BGKv5u0XoEQqPmug0GcQvuCNxr\r
  34         FIwA==\r
  35 X-Gm-Message-State:\r
  36  ALoCoQn5KZG5Ybk71FNh8x1eCCTr+GlehO7Cy1f/I1XBzrWFQrPfcxucQLr2PRiWi4C8mr9B9gTa\r
  37 X-Received: by 10.15.53.193 with SMTP id r41mr2806156eew.2.1385847324380;\r
  38         Sat, 30 Nov 2013 13:35:24 -0800 (PST)\r
  39 Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi.\r
  40         [88.195.111.91])\r
  41         by mx.google.com with ESMTPSA id g1sm54513090eew.1.2013.11.30.13.35.22\r
  42         for <multiple recipients>\r
  43         (version=TLSv1.2 cipher=RC4-SHA bits=128/128);\r
  44         Sat, 30 Nov 2013 13:35:23 -0800 (PST)\r
  45 From: Jani Nikula <jani@nikula.org>\r
  46 To: David Bremner <david@tethera.net>, notmuch@notmuchmail.org\r
  47 Subject: Re: [PATCH 0/2] library reference man page\r
  48 In-Reply-To: <87haat4pws.fsf@zancas.localnet>\r
  49 References: <cover.1385826040.git.jani@nikula.org>\r
  50         <87haat4pws.fsf@zancas.localnet>\r
  51 User-Agent: Notmuch/0.16+145~gebbaa94 (http://notmuchmail.org) Emacs/24.3.1\r
  52         (x86_64-pc-linux-gnu)\r
  53 Date: Sat, 30 Nov 2013 23:35:19 +0200\r
  54 Message-ID: <87r49xshd4.fsf@nikula.org>\r
  55 MIME-Version: 1.0\r
  56 Content-Type: text/plain\r
  57 X-BeenThere: notmuch@notmuchmail.org\r
  58 X-Mailman-Version: 2.1.13\r
  59 Precedence: list\r
  60 List-Id: "Use and development of the notmuch mail system."\r
  61         <notmuch.notmuchmail.org>\r
  62 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  63         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  64 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  65 List-Post: <mailto:notmuch@notmuchmail.org>\r
  66 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  67 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  68         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  69 X-List-Received-Date: Sat, 30 Nov 2013 21:40:41 -0000\r
  70 \r
  71 On Sat, 30 Nov 2013, David Bremner <david@tethera.net> wrote:\r
  72 > Jani Nikula <jani@nikula.org> writes:\r
  73 >>\r
  74 >>  devel/doxygen.cfg | 1890 +++++++++++++++++++++++++++++++++++++++++++++++++++++\r
  75 >>  lib/notmuch.h     |  436 ++++++++----\r
  76 >\r
  77 > A 2K line config file is kindof gross, but other than that, I think the\r
  78 > idea has merit. Do we really need that much configuration info?\r
  79 \r
  80 The config file is basically a template generated with 'doxygen -g' and\r
  81 adjusted to our needs. It could be significantly reduced by dropping\r
  82 comments, defaults, and unused settings. Maybe that would be the right\r
  83 thing to do, even if the comments and defaults that are set explicitly\r
  84 serve as documentation.\r
  85 \r
  86 > Perhaps a quibble, but at least for me the summary part of the resulting\r
  87 > manpage is almost unreadable because of the amount of underlining.\r
  88 \r
  89 Agreed, it's not optimal. I was hoping someone more experienced with\r
  90 doxygen would fix that after I shared this initial work. ;)\r
  91 \r
  92 BR,\r
  93 Jani.\r