[PATCH v3 0/5] rst2man.py support and doc-build cleanups
authorW. Trevor King <wking@tremily.us>
Sun, 13 Jul 2014 03:10:32 +0000 (20:10 +1700)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 18:03:31 +0000 (10:03 -0800)
53/22b2ce4bdc18102206b8df704f352e289815ea [new file with mode: 0644]

diff --git a/53/22b2ce4bdc18102206b8df704f352e289815ea b/53/22b2ce4bdc18102206b8df704f352e289815ea
new file mode 100644 (file)
index 0000000..2bb76a3
--- /dev/null
@@ -0,0 +1,112 @@
+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 21CF7431FC3\r
+       for <notmuch@notmuchmail.org>; Sat, 12 Jul 2014 20:11:38 -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 NEo7rcG7RY7U for <notmuch@notmuchmail.org>;\r
+       Sat, 12 Jul 2014 20:11:29 -0700 (PDT)\r
+Received: from qmta01.emeryville.ca.mail.comcast.net\r
+       (qmta01.emeryville.ca.mail.comcast.net [76.96.30.16])\r
+       by olra.theworths.org (Postfix) with ESMTP id 1548A431FBC\r
+       for <notmuch@notmuchmail.org>; Sat, 12 Jul 2014 20:11:28 -0700 (PDT)\r
+Received: from omta02.emeryville.ca.mail.comcast.net ([76.96.30.19])\r
+       by qmta01.emeryville.ca.mail.comcast.net with comcast\r
+       id Rf0J1o0020QkzPwA1fBUEb; Sun, 13 Jul 2014 03:11:28 +0000\r
+Received: from odin.tremily.us ([24.18.63.50])\r
+       by omta02.emeryville.ca.mail.comcast.net with comcast\r
+       id RfBS1o004152l3L8NfBSd3; Sun, 13 Jul 2014 03:11:27 +0000\r
+Received: from mjolnir.tremily.us (unknown [192.168.0.150])\r
+       by odin.tremily.us (Postfix) with ESMTPS id CD0C71286EFF;\r
+       Sat, 12 Jul 2014 20:11:25 -0700 (PDT)\r
+Received: (nullmailer pid 31443 invoked by uid 1000);\r
+       Sun, 13 Jul 2014 03:10:43 -0000\r
+From: "W. Trevor King" <wking@tremily.us>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH v3 0/5] rst2man.py support and doc-build cleanups\r
+Date: Sat, 12 Jul 2014 20:10:32 -0700\r
+Message-Id: <cover.1405220724.git.wking@tremily.us>\r
+X-Mailer: git-send-email 1.9.1.353.gc66d89d\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=UTF-8\r
+Content-Transfer-Encoding: 8bit\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
+       s=q20140121; t=1405221088;\r
+       bh=hLeNRkHdvrG+zeFymJ1d5wvGVZa5ZOLRiD1PoMbIS7M=;\r
+       h=Received:Received:Received:Received:From:To:Subject:Date:\r
+       Message-Id:MIME-Version:Content-Type;\r
+       b=qQrnaKtUeb23tFolzAaW4cumr+0O26f80BOhXOdORNiA46ifEvNVKDcYWyHqdLPvc\r
+       kSt5lGKGkdc2Xw+S0f+WmfOVeEgQ5LajrL74FSQ0dmA8zFoC1HW/bHrtuNpnPXosaR\r
+       bKzfM5LFbIM5M+zextU/WH704D6luEIlUm5G2Zpr3WMUg+jXW7OpFIjUSDtlCchQSf\r
+       aYR6i1Bv4ME1TmFddCM2pzbFsDYZq7cSygzV6VhJ3mSgqWSK1uUgnI6jJfDvZtGsND\r
+       F38ghdvQjklQJcqYPLT0PLrVoyH8yNX+C5ESLQCeYcUvDKKPTPOC8rc1HesJuxRQrj\r
+       3fefQc/02inYA==\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: Sun, 13 Jul 2014 03:11:38 -0000\r
+\r
+Changes since v2 [1]:\r
+\r
+* In patches 1/5 and 5/5, use for loops to check for rst2man[.py] and\r
+  rst2html[.py].\r
+* In patches 1/5 and 5/5, store the command names, not the full paths\r
+  (command -v …) [2].\r
+* In patch 3/5, I've added argparse handling to the newly-renamed\r
+  rst-man2any.py.  Tomi suggested modeling the name and UI on texi2any\r
+  [3], but texi2any is for converting a single file, while\r
+  rst-man2any.py is for converting a whole tree (and it takes an\r
+  arbitrary ReST-to-$x converter to do the real work).  I've basically\r
+  just cleaned things up, but if folks aren't satisfied I'm going to\r
+  need more concrete suggestions ;).\r
+\r
+Cheers,\r
+Trevor\r
+\r
+[1]: id:cover.1399740604.git.wking@tremily.us\r
+     http://thread.gmane.org/gmane.mail.notmuch.general/18291\r
+[2]: id:m2ion3dn0r.fsf@guru.guru-group.fi\r
+     http://article.gmane.org/gmane.mail.notmuch.general/18652\r
+[3]: id:m2lhrzj8kb.fsf@guru.guru-group.fi\r
+     http://article.gmane.org/gmane.mail.notmuch.general/18653\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/rst-man2any.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          |  45 ++++++++++++++++++++---\r
+ doc/INSTALL        |  47 +++++++++++++++++-------\r
+ doc/Makefile.local |  48 ++++++++++++++----------\r
+ doc/prerst2man.py  |  63 --------------------------------\r
+ doc/rst-man2any.py | 105 +++++++++++++++++++++++++++++++++++++++++++++++++++++\r
+ 6 files changed, 217 insertions(+), 105 deletions(-)\r
+ delete mode 100644 doc/prerst2man.py\r
+ create mode 100755 doc/rst-man2any.py\r
+\r
+-- \r
+1.9.1.353.gc66d89d\r
+\r