0b/5e99ac1a73300e7afc36cdbf9765a8ee819e2a

   1 Return-Path: <tomi.ollila@iki.fi>\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 C6E40431FC0\r
   6         for <notmuch@notmuchmail.org>; Wed,  1 Jan 2014 06:16:10 -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\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
  12         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 Az01wVNNV8VG for <notmuch@notmuchmail.org>;\r
  16         Wed,  1 Jan 2014 06:16:04 -0800 (PST)\r
  17 Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
  18         by olra.theworths.org (Postfix) with ESMTP id 839C4431FAF\r
  19         for <notmuch@notmuchmail.org>; Wed,  1 Jan 2014 06:16:04 -0800 (PST)\r
  20 Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
  21         by guru.guru-group.fi (Postfix) with ESMTP id 639B81000B2;\r
  22         Wed,  1 Jan 2014 16:15:56 +0200 (EET)\r
  23 From: Tomi Ollila <tomi.ollila@iki.fi>\r
  24 To: Jani Nikula <jani@nikula.org>, David Bremner <david@tethera.net>,\r
  25         notmuch@notmuchmail.org\r
  26 Subject: Re: [PATCH 0/2] library reference man page\r
  27 In-Reply-To: <87r49xshd4.fsf@nikula.org>\r
  28 References: <cover.1385826040.git.jani@nikula.org>\r
  29         <87haat4pws.fsf@zancas.localnet> <87r49xshd4.fsf@nikula.org>\r
  30 User-Agent: Notmuch/0.17+13~gdfcf116 (http://notmuchmail.org) Emacs/24.3.1\r
  31         (x86_64-unknown-linux-gnu)\r
  32 X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
  33         $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
  34         !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
  35 Date: Wed, 01 Jan 2014 16:15:55 +0200\r
  36 Message-ID: <m261q3pz38.fsf@guru.guru-group.fi>\r
  37 MIME-Version: 1.0\r
  38 Content-Type: text/plain\r
  39 X-BeenThere: notmuch@notmuchmail.org\r
  40 X-Mailman-Version: 2.1.13\r
  41 Precedence: list\r
  42 List-Id: "Use and development of the notmuch mail system."\r
  43         <notmuch.notmuchmail.org>\r
  44 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  45         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  46 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  47 List-Post: <mailto:notmuch@notmuchmail.org>\r
  48 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  49 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  50         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  51 X-List-Received-Date: Wed, 01 Jan 2014 14:16:10 -0000\r
  52 \r
  53 On Sat, Nov 30 2013, Jani Nikula <jani@nikula.org> wrote:\r
  54 \r
  55 > On Sat, 30 Nov 2013, David Bremner <david@tethera.net> wrote:\r
  56 >> Jani Nikula <jani@nikula.org> writes:\r
  57 >>>\r
  58 >>>  devel/doxygen.cfg | 1890 +++++++++++++++++++++++++++++++++++++++++++++++++++++\r
  59 >>>  lib/notmuch.h     |  436 ++++++++----\r
  60 >>\r
  61 >> A 2K line config file is kindof gross, but other than that, I think the\r
  62 >> idea has merit. Do we really need that much configuration info?\r
  63 >\r
  64 > The config file is basically a template generated with 'doxygen -g' and\r
  65 > adjusted to our needs. It could be significantly reduced by dropping\r
  66 > comments, defaults, and unused settings. Maybe that would be the right\r
  67 > thing to do, even if the comments and defaults that are set explicitly\r
  68 > serve as documentation.\r
  69 >\r
  70 >> Perhaps a quibble, but at least for me the summary part of the resulting\r
  71 >> manpage is almost unreadable because of the amount of underlining.\r
  72 >\r
  73 > Agreed, it's not optimal. I was hoping someone more experienced with\r
  74 > doxygen would fix that after I shared this initial work. ;)\r
  75 \r
  76 $ doxygen -g -s\r
  77 ...\r
  78 $ wc Doxyfile\r
  79   305   861 10677 Doxyfile\r
  80 \r
  81 ;)\r
  82 \r
  83 Maybe keeping the defaults is better than hassle with just the changed\r
  84 options ?\r
  85 \r
  86 \r
  87 > BR,\r
  88 > Jani.\r
  89 \r
  90 Tomi\r