df/0c8bf9c2b88c1531dd0e5ab54f9378bfb47cc2

   1 Return-Path: <bremner@tethera.net>\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 3BDAA431FAE\r
   6         for <notmuch@notmuchmail.org>; Wed,  5 Mar 2014 06:56:50 -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 A+A4qhmSBy-C for <notmuch@notmuchmail.org>;\r
  16         Wed,  5 Mar 2014 06:56:44 -0800 (PST)\r
  17 Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155])\r
  18         (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id 1D775431FBD\r
  21         for <notmuch@notmuchmail.org>; Wed,  5 Mar 2014 06:56:44 -0800 (PST)\r
  22 Received: from remotemail by yantan.tethera.net with local (Exim 4.80)\r
  23         (envelope-from <bremner@tethera.net>)\r
  24         id 1WLDFT-00049Q-LU; Wed, 05 Mar 2014 10:56:43 -0400\r
  25 Received: (nullmailer pid 10385 invoked by uid 1000); Wed, 05 Mar 2014\r
  26         14:56:37 -0000\r
  27 From: David Bremner <david@tethera.net>\r
  28 To: notmuch@notmuchmail.org\r
  29 Subject: [PATCH 3/4] doc: install sphinx version of man pages\r
  30 Date: Wed,  5 Mar 2014 10:56:34 -0400\r
  31 Message-Id: <1394031395-8014-4-git-send-email-david@tethera.net>\r
  32 X-Mailer: git-send-email 1.8.5.3\r
  33 In-Reply-To: <1394031395-8014-1-git-send-email-david@tethera.net>\r
  34 References: <1394031395-8014-1-git-send-email-david@tethera.net>\r
  35 X-BeenThere: notmuch@notmuchmail.org\r
  36 X-Mailman-Version: 2.1.13\r
  37 Precedence: list\r
  38 List-Id: "Use and development of the notmuch mail system."\r
  39         <notmuch.notmuchmail.org>\r
  40 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  41         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  42 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  43 List-Post: <mailto:notmuch@notmuchmail.org>\r
  44 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  45 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  46         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  47 X-List-Received-Date: Wed, 05 Mar 2014 14:56:50 -0000\r
  48 \r
  49 The python script mkdocdeps.py is used to import the list of man pages\r
  50 from the sphinx configuration to make.\r
  51 \r
  52 This will delete the (release only) target update-man-versions. This\r
  53 will be replaced in a followup commit.\r
  54 ---\r
  55  Makefile           |  2 +-\r
  56  Makefile.local     |  2 +-\r
  57  doc/Makefile.local | 27 ++++++++++++++++++++++++++-\r
  58  doc/mkdocdeps.py   | 13 +++++++++++++\r
  59  man/Makefile.local | 55 ------------------------------------------------------\r
  60  5 files changed, 41 insertions(+), 58 deletions(-)\r
  61  create mode 100644 doc/mkdocdeps.py\r
  62  delete mode 100644 man/Makefile.local\r
  63 \r
  64 diff --git a/Makefile b/Makefile\r
  65 index 39f0e62..f53bec0 100644\r
  66 --- a/Makefile\r
  67 +++ b/Makefile\r
  68 @@ -5,7 +5,7 @@ all:\r
  69  # List all subdirectories here. Each contains its own Makefile.local.\r
  70  # Use of '=', without '+=', seems to be required for out-of-tree\r
  71  # builds to work.\r
  72 -subdirs = compat completion doc emacs lib man parse-time-string performance-test util test\r
  73 +subdirs = compat completion doc emacs lib parse-time-string performance-test util test\r
  74  \r
  75  # We make all targets depend on the Makefiles themselves.\r
  76  global_deps = Makefile Makefile.config Makefile.local \\r
  77 diff --git a/Makefile.local b/Makefile.local\r
  78 index 174506c..5f797ad 100644\r
  79 --- a/Makefile.local\r
  80 +++ b/Makefile.local\r
  81 @@ -95,7 +95,7 @@ dist: $(TAR_FILE)\r
  82  \r
  83  .PHONY: update-versions\r
  84  \r
  85 -update-versions: update-man-versions\r
  86 +update-versions:\r
  87         sed -i "s/^__VERSION__[[:blank:]]*=.*$$/__VERSION__ = \'${VERSION}\'/" $(PV_FILE)\r
  88  \r
  89  # We invoke make recursively only to force ordering of our phony\r
  90 diff --git a/doc/Makefile.local b/doc/Makefile.local\r
  91 index 4719247..19861a7 100644\r
  92 --- a/doc/Makefile.local\r
  93 +++ b/doc/Makefile.local\r
  94 @@ -8,6 +8,7 @@ SPHINXBUILD   = sphinx-build\r
  95  DOCBUILDDIR      := $(dir)/_build\r
  96  \r
  97  prerst2man := python $(dir)/prerst2man.py\r
  98 +mkdocdeps := python $(dir)/mkdocdeps.py\r
  99  \r
 100  # Internal variables.\r
 101  ALLSPHINXOPTS   := -d $(DOCBUILDDIR)/doctrees $(SPHINXOPTS) $(dir)\r
 102 @@ -15,6 +16,11 @@ ALLSPHINXOPTS   := -d $(DOCBUILDDIR)/doctrees $(SPHINXOPTS) $(dir)\r
 103  .PHONY: sphinx-html sphinx-man sphinx-texinfo sphinx-info\r
 104  .PHONY: rst2man\r
 105  \r
 106 +.PHONY: install-man\r
 107 +\r
 108 +%.gz: %\r
 109 +       gzip -k -f $^\r
 110 +\r
 111  sphinx-html:\r
 112         $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(DOCBUILDDIR)/html\r
 113  \r
 114 @@ -31,4 +37,23 @@ sphinx-info: sphinx-texinfo\r
 115  rst2man:\r
 116         $(prerst2man) $(DOCBUILDDIR)/.. $(DOCBUILDDIR)/man\r
 117  \r
 118 -CLEAN := $(CLEAN) $(DOCBUILDDIR)\r
 119 +include $(dir)/docdeps.mk\r
 120 +\r
 121 +MAN_GZIP_FILES := $(addsuffix .gz,${MAN_ROFF_FILES})\r
 122 +\r
 123 +${MAN_ROFF_FILES} : sphinx-man\r
 124 +\r
 125 +install-man: ${MAN_GZIP_FILES}\r
 126 +       mkdir -p "$(DESTDIR)$(mandir)/man1"\r
 127 +       mkdir -p "$(DESTDIR)$(mandir)/man5"\r
 128 +       mkdir -p "$(DESTDIR)$(mandir)/man7"\r
 129 +       install -m0644 $(DOCBUILDDIR)/man/*.1.gz $(DESTDIR)/$(mandir)/man1\r
 130 +       install -m0644 $(DOCBUILDDIR)/man/*.5.gz $(DESTDIR)/$(mandir)/man5\r
 131 +       install -m0644 $(DOCBUILDDIR)/man/*.7.gz $(DESTDIR)/$(mandir)/man7\r
 132 +       cd $(DESTDIR)/$(mandir)/man1 && ln -sf notmuch.1.gz notmuch-setup.1.gz\r
 133 +\r
 134 +\r
 135 +$(dir)/docdeps.mk: $(dir)/conf.py $(dir)/mkdocdeps.py\r
 136 +       $(mkdocdeps) $< $(DOCBUILDDIR) $@\r
 137 +\r
 138 +CLEAN := $(CLEAN) $(DOCBUILDDIR) $(dir)/docdeps.mk\r
 139 diff --git a/doc/mkdocdeps.py b/doc/mkdocdeps.py\r
 140 new file mode 100644\r
 141 index 0000000..2f4a959\r
 142 --- /dev/null\r
 143 +++ b/doc/mkdocdeps.py\r
 144 @@ -0,0 +1,13 @@\r
 145 +from sys import argv\r
 146 +conffile = argv[1]\r
 147 +builddir = argv[2]\r
 148 +outfile = argv[3]\r
 149 +\r
 150 +execfile(conffile)\r
 151 +\r
 152 +roff_files = []\r
 153 +out=open(outfile,'w')\r
 154 +for page in man_pages:\r
 155 +    roff_files = roff_files + ["{0:s}/man/{1:s}.{2:d}".format(builddir,page[1],page[4])]\r
 156 +\r
 157 +out.write ('MAN_ROFF_FILES := ' + ' \\\n\t'.join(roff_files)+'\n')\r
 158 diff --git a/man/Makefile.local b/man/Makefile.local\r
 159 deleted file mode 100644\r
 160 index 57910b7..0000000\r
 161 --- a/man/Makefile.local\r
 162 +++ /dev/null\r
 163 @@ -1,55 +0,0 @@\r
 164 -# -*- Makefile -*-\r
 165 -\r
 166 -dir := man\r
 167 -\r
 168 -# this variable seems to be needed to prevent lazy evaluation causing\r
 169 -# problems with $(dir) changing values.\r
 170 -MAIN_PAGE := $(dir)/man1/notmuch.1\r
 171 -\r
 172 -MAN1 := \\r
 173 -       $(MAIN_PAGE) \\r
 174 -       $(dir)/man1/notmuch-compact.1 \\r
 175 -       $(dir)/man1/notmuch-config.1 \\r
 176 -       $(dir)/man1/notmuch-count.1 \\r
 177 -       $(dir)/man1/notmuch-dump.1 \\r
 178 -       $(dir)/man1/notmuch-restore.1 \\r
 179 -       $(dir)/man1/notmuch-insert.1 \\r
 180 -       $(dir)/man1/notmuch-new.1 \\r
 181 -       $(dir)/man1/notmuch-reply.1 \\r
 182 -       $(dir)/man1/notmuch-search.1 \\r
 183 -       $(dir)/man1/notmuch-show.1 \\r
 184 -       $(dir)/man1/notmuch-tag.1\r
 185 -\r
 186 -MAN5 := $(dir)/man5/notmuch-hooks.5\r
 187 -MAN7 := $(dir)/man7/notmuch-search-terms.7\r
 188 -\r
 189 -MAN1_GZ := $(addsuffix .gz,$(MAN1))\r
 190 -MAN5_GZ := $(addsuffix .gz,$(MAN5))\r
 191 -MAN7_GZ := $(addsuffix .gz,$(MAN7))\r
 192 -\r
 193 -MAN_SOURCE := $(MAN1) $(MAN5) $(MAN7)\r
 194 -MAN_BACKUP := $(addsuffix .bak,$(MAN_SOURCE))\r
 195 -COMPRESSED_MAN := $(MAN1_GZ) $(MAN5_GZ) $(MAN7_GZ)\r
 196 -\r
 197 -%.gz: %\r
 198 -       gzip --stdout $^ > $@\r
 199 -\r
 200 -.PHONY: install-man update-man-versions\r
 201 -\r
 202 -install-man: $(COMPRESSED_MAN)\r
 203 -       mkdir -p "$(DESTDIR)$(mandir)/man1"\r
 204 -       mkdir -p "$(DESTDIR)$(mandir)/man5"\r
 205 -       mkdir -p "$(DESTDIR)$(mandir)/man7"\r
 206 -       install -m0644 $(MAN1_GZ) $(DESTDIR)/$(mandir)/man1\r
 207 -       install -m0644 $(MAN5_GZ) $(DESTDIR)/$(mandir)/man5\r
 208 -       install -m0644 $(MAN7_GZ) $(DESTDIR)/$(mandir)/man7\r
 209 -       cd $(DESTDIR)/$(mandir)/man1 && ln -sf notmuch.1.gz notmuch-setup.1.gz\r
 210 -\r
 211 -update-man-versions: $(MAN_SOURCE)\r
 212 -       for file in $(MAN_SOURCE); do \\r
 213 -           cp $$file $$file.bak ; \\r
 214 -           sed "s/^.TH NOTMUCH\([^[:blank:]]*\) \([1-9]\) .*$$/.TH NOTMUCH\1 \2 ${DATE} \"Notmuch ${VERSION}\"/" \\r
 215 -               < $$file.bak > $$file; \\r
 216 -       done\r
 217 -\r
 218 -CLEAN := $(CLEAN) $(COMPRESSED_MAN) $(MAN_BACKUP)\r
 219 -- \r
 220 1.8.5.3\r
 221 \r