[PATCH v2 0/5] rst2man.py support and doc-build cleanups
authorW. Trevor King <wking@tremily.us>
Sat, 10 May 2014 17:03:31 +0000 (10:03 +1700)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 18:02:36 +0000 (10:02 -0800)
c3/31e1e85084eb3a99868c2880a8bf7262eed0ef [new file with mode: 0644]

diff --git a/c3/31e1e85084eb3a99868c2880a8bf7262eed0ef b/c3/31e1e85084eb3a99868c2880a8bf7262eed0ef
new file mode 100644 (file)
index 0000000..e6a3c3e
--- /dev/null
@@ -0,0 +1,125 @@
+Return-Path: <wking@tremily.us>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 1FCE9431FC7\r
+       for <notmuch@notmuchmail.org>; Sat, 10 May 2014 10:04:26 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0 tagged_above=-999 required=5\r
+       tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001]\r
+       autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id MJfhYOzS4GLt for <notmuch@notmuchmail.org>;\r
+       Sat, 10 May 2014 10:04:18 -0700 (PDT)\r
+Received: from qmta04.westchester.pa.mail.comcast.net\r
+       (qmta04.westchester.pa.mail.comcast.net [76.96.62.40])\r
+       by olra.theworths.org (Postfix) with ESMTP id D0770431FBF\r
+       for <notmuch@notmuchmail.org>; Sat, 10 May 2014 10:04:17 -0700 (PDT)\r
+Received: from omta10.westchester.pa.mail.comcast.net ([76.96.62.28])\r
+       by qmta04.westchester.pa.mail.comcast.net with comcast\r
+       id 0Gua1o0050cZkys54H4H66; Sat, 10 May 2014 17:04:17 +0000\r
+Received: from odin.tremily.us ([24.18.63.50])\r
+       by omta10.westchester.pa.mail.comcast.net with comcast\r
+       id 0H4F1o00Y152l3L3WH4Gqw; Sat, 10 May 2014 17:04:17 +0000\r
+Received: from mjolnir.tremily.us (unknown [192.168.0.140])\r
+       by odin.tremily.us (Postfix) with ESMTPS id 9121411969A2;\r
+       Sat, 10 May 2014 10:04:15 -0700 (PDT)\r
+Received: (nullmailer pid 24524 invoked by uid 1000);\r
+       Sat, 10 May 2014 17:03:43 -0000\r
+From: "W. Trevor King" <wking@tremily.us>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH v2 0/5] rst2man.py support and doc-build cleanups\r
+Date: Sat, 10 May 2014 10:03:31 -0700\r
+Message-Id: <cover.1399740604.git.wking@tremily.us>\r
+X-Mailer: git-send-email 1.9.1.353.gc66d89d\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
+       s=q20140121; t=1399741457;\r
+       bh=WRmUdTxirujjsEwA77yF6SuIPm1McVC5OSXlZqH6mFY=;\r
+       h=Received:Received:Received:Received:From:To:Subject:Date:\r
+       Message-Id;\r
+       b=W7q5m7KF3fZQPKGgbV76uFLwnBTEGMp8vjaru7d7TYbQXYedLEILaKUeznuOjKzHt\r
+       R3xHTUufCIcx+8yAVZMfTRRJndsPnFpvW/ZlnTyLAFJwcqvmGhnCV+nopAkzQS2cC1\r
+       hBccBFbZ/5JcZBPZFfIV4nvuUDcQ6ruhNE2LV5dfovUAVEts8/5ulSqu9P6XtSkFd+\r
+       FElYheLX3OI+01MN/m1ZH7nqWfiRi8KjaaV1pG+cFhCqYLHsnGLNccwkGqgYlIX34d\r
+       2Q2aPi/HV9ZWuvS+M3ttdgn1POqdGymclL0hkz1RCKClvHRWgHfRz2DelUnkBs0io2\r
+       mvpEi77bZlYGg==\r
+Cc: Tomi Ollila <tomi.ollila@iki.fi>\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sat, 10 May 2014 17:04:26 -0000\r
+\r
+The first four patches from v1 have already landed in master.\r
+This series is v2 of the remainder of the series [1].\r
+\r
+In patch 1/5 (v1's 5/7):\r
+\r
+* Explicitly empty RST2MAN [2,3], rather than letting external\r
+  environment variables fall through (or explicitly using them to\r
+  bypass configure's detection code [4]).\r
+* Restore HAVE_RST2MAN instead of using non-empty RST2MAN [5].  I'm\r
+  willing to go along with this (hence the patch), but I'd prefer\r
+  dropping the HAVE_* variables.  More details in the commit message\r
+  for patch 5/5.\r
+\r
+In patch 4/5 (v1's 7/7):\r
+\r
+* Add a '.. -*- rst -*-' prefix to doc/INSTALL [6].\r
+* Fix 'build build' -> 'build' [7].\r
+* Fix 'Building the man Docutils' -> 'Building with Docutils' [7].\r
+* Standardize on build-{html|info|man} and install-{info|man} [8].\r
+* Add notes about the Sphinx/Docutils variables [7].\r
+\r
+Patches 3/5 and 5/5 are new since v1, and add Sphinx-less support for\r
+build-html.\r
+\r
+[1]: id:cover.1396718720.git.wking@tremily.us\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17732\r
+[2]: id:m2a9bzd2bo.fsf@guru.guru-group.fi\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17742\r
+[3]: id:m21txac0qy.fsf@guru.guru-group.fi\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17775\r
+[4]: id:20140405191917.GF5316@odin.tremily.us\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17745\r
+[5]: id:m24n26c1m9.fsf@guru.guru-group.fi\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17774\r
+[6]: id:87wqejtxs9.fsf@maritornes.cs.unb.ca\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17956\r
+[7]: id:874n271plm.fsf@maritornes.cs.unb.ca\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17746\r
+[8]: id:871txb1j8z.fsf@maritornes.cs.unb.ca\r
+     http://article.gmane.org/gmane.mail.notmuch.general/17754\r
+\r
+W. Trevor King (5):\r
+  doc: Allow rst2man.py as an alternative to rst2man\r
+  doc/prerst2man.py: Convert execfile to import\r
+  doc/prerst2x.py: Adjust to handle any output format, not just man\r
+    pages\r
+  doc: Consolidate Makefile targets around {build|install}-{format}\r
+  doc: Add rst2html support for building HTML docs\r
+\r
+ Makefile.local     | 14 ++++++++--\r
+ configure          | 41 ++++++++++++++++++++++++++---\r
+ doc/INSTALL        | 47 ++++++++++++++++++++++++----------\r
+ doc/Makefile.local | 48 +++++++++++++++++++---------------\r
+ doc/prerst2man.py  | 63 ---------------------------------------------\r
+ doc/prerst2x.py    | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++++\r
+ 6 files changed, 186 insertions(+), 102 deletions(-)\r
+ delete mode 100644 doc/prerst2man.py\r
+ create mode 100644 doc/prerst2x.py\r
+\r
+-- \r
+1.9.1.353.gc66d89d\r