Return-Path: <bremner@tesseract.cs.unb.ca>
X-Original-To: notmuch@notmuchmail.org
Delivered-To: notmuch@notmuchmail.org
Received: from localhost (localhost [127.0.0.1])
	by olra.theworths.org (Postfix) with ESMTP id 28A52431E62
	for <notmuch@notmuchmail.org>; Sun,  6 Jul 2014 10:54:06 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
X-Spam-Flag: NO
X-Spam-Score: 0
X-Spam-Level: 
X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]
	autolearn=disabled
Received: from olra.theworths.org ([127.0.0.1])
	by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id dZiWBui0XGcl for <notmuch@notmuchmail.org>;
	Sun,  6 Jul 2014 10:54:02 -0700 (PDT)
Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155])
	(using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))
	(No client certificate requested)
	by olra.theworths.org (Postfix) with ESMTPS id 26EF4431FD6
	for <notmuch@notmuchmail.org>; Sun,  6 Jul 2014 10:53:49 -0700 (PDT)
Received: from remotemail by yantan.tethera.net with local (Exim 4.80)
	(envelope-from <bremner@tesseract.cs.unb.ca>) id 1X3qdF-0001Hx-Ot
	for notmuch@notmuchmail.org; Sun, 06 Jul 2014 14:53:45 -0300
Received: (nullmailer pid 30891 invoked by uid 1000); Sun, 06 Jul 2014
	14:46:38 -0000
From: David Bremner <david@tethera.net>
To: notmuch@notmuchmail.org
Subject: build and install api docs with doxygen
Date: Sun,  6 Jul 2014 11:46:31 -0300
Message-Id: <1404657994-30628-1-git-send-email-david@tethera.net>
X-Mailer: git-send-email 2.0.0.rc2
X-BeenThere: notmuch@notmuchmail.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: "Use and development of the notmuch mail system."
	<notmuch.notmuchmail.org>
List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
List-Archive: <http://notmuchmail.org/pipermail/notmuch>
List-Post: <mailto:notmuch@notmuchmail.org>
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=subscribe>
X-List-Received-Date: Sun, 06 Jul 2014 17:54:06 -0000

In my testing this version works ok with and without doxygen, and in
and out of tree. But I only tested in Debian jessie (testing), so other tests would be welcome.

It's a bit lame that we have to generate doxygen config file snippet
on the fly just to support out of tree builds, but doxygen seems to
have very limited support for options on the command line.

The second two patches are essentially cosmetic, although without
patch 3/3 the docs are bit eye-burningly-ugly