d4/7e3b768ac6f42a6e12e7775b4ae94b5cedf064

   1 Return-Path: <jani@nikula.org>\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 CB9CA431FB6\r
   6         for <notmuch@notmuchmail.org>; Sun, 18 Jan 2015 11:44:48 -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: 1.739\r
  10 X-Spam-Level: *\r
  11 X-Spam-Status: No, score=1.739 tagged_above=-999 required=5\r
  12         tests=[DNS_FROM_AHBL_RHSBL=2.438, HTML_MESSAGE=0.001,\r
  13         RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id Oi5jKMAruayZ for <notmuch@notmuchmail.org>;\r
  17         Sun, 18 Jan 2015 11:44:45 -0800 (PST)\r
  18 Received: from mail-lb0-f182.google.com (mail-lb0-f182.google.com\r
  19         [209.85.217.182]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  20         (No client certificate requested)\r
  21         by olra.theworths.org (Postfix) with ESMTPS id 486A2431FAF\r
  22         for <notmuch@notmuchmail.org>; Sun, 18 Jan 2015 11:44:45 -0800 (PST)\r
  23 Received: by mail-lb0-f182.google.com with SMTP id u10so24968968lbd.13\r
  24         for <notmuch@notmuchmail.org>; Sun, 18 Jan 2015 11:44:42 -0800 (PST)\r
  25 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  26         d=1e100.net; s=20130820;\r
  27         h=x-gm-message-state:mime-version:in-reply-to:references:date\r
  28         :message-id:subject:from:to:cc:content-type;\r
  29         bh=kNPFNURgMPqn3UFKH1gt0E7cm6sDrl2mBGmWYXelfik=;\r
  30         b=IDONrnndH8mnzuWuHvg6+HaOKIvz2umXle6NpnepSkYEznHSODS8tOlXmoSfvopCsO\r
  31         gmMC7qKGP/ET4Epg99FJK0NKepsWME8i9J0pJ7CkzLlytccpK195V+HD5v4sDJMzkXI1\r
  32         4OgRH2cF77xvl7RcNkgPGZbyiCx4WUdKYJo8eIdtUJ8+eGHHNOLZDW+sD70NnIRDd/Y+\r
  33         FNiDkK9jtT2eHShXjlj5mSKqeaI6d1TOgrpAZ5cX/4wur6eNPRt0Ic4wGRnO9EpNSqIT\r
  34         7tTtCqAAS89dSON4TrRVgzj47juafI/nFFxGspdAt2qiFG5+Mc6EjwoSsEBv9JJWC+1s\r
  35         w0Yg==\r
  36 X-Gm-Message-State:\r
  37  ALoCoQlBOxQNZfV5h791Faadf7dseXUs0ppP5lwNWsrm6uMIvHlG0zTXQrnJBu9Sx63s75TBYX0v\r
  38 MIME-Version: 1.0\r
  39 X-Received: by 10.112.119.167 with SMTP id kv7mr26201348lbb.62.1421610282610; \r
  40         Sun, 18 Jan 2015 11:44:42 -0800 (PST)\r
  41 Received: by 10.25.160.143 with HTTP; Sun, 18 Jan 2015 11:44:42 -0800 (PST)\r
  42 Received: by 10.25.160.143 with HTTP; Sun, 18 Jan 2015 11:44:42 -0800 (PST)\r
  43 In-Reply-To: <1421600110-19988-1-git-send-email-david@tethera.net>\r
  44 References: <87k312x4i2.fsf@maritornes.cs.unb.ca>\r
  45         <1421600110-19988-1-git-send-email-david@tethera.net>\r
  46 Date: Sun, 18 Jan 2015 21:44:42 +0200\r
  47 Message-ID:\r
  48  <CAB+hUn_Uxj2Ozsw8ymLxMk0RZ6g9kYjM+GLzcX6zrQt4rhMMOQ@mail.gmail.com>\r
  49 Subject: Re: [PATCH] doc: remove support for rst2man\r
  50 From: Jani Nikula <jani@nikula.org>\r
  51 To: David Bremner <david@tethera.net>\r
  52 Content-Type: multipart/alternative; boundary=047d7b874450e78936050cf26f93\r
  53 Cc: Notmuch Mail <notmuch@notmuchmail.org>\r
  54 X-BeenThere: notmuch@notmuchmail.org\r
  55 X-Mailman-Version: 2.1.13\r
  56 Precedence: list\r
  57 List-Id: "Use and development of the notmuch mail system."\r
  58         <notmuch.notmuchmail.org>\r
  59 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  60         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  61 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  62 List-Post: <mailto:notmuch@notmuchmail.org>\r
  63 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  64 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  65         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  66 X-List-Received-Date: Sun, 18 Jan 2015 19:44:48 -0000\r
  67 \r
  68 --047d7b874450e78936050cf26f93\r
  69 Content-Type: text/plain; charset=UTF-8\r
  70 \r
  71 On Jan 18, 2015 6:56 PM, "David Bremner" <david@tethera.net> wrote:\r
  72 >\r
  73 > It was becoming increasingly complicated to support rst2man, and there\r
  74 > were apparently not many people that relied on it.\r
  75 > ---\r
  76 >\r
  77 > Now's your chance to tell us how useful rst2man support is to you.\r
  78 >\r
  79 >  INSTALL            |  7 ++----\r
  80 >  NEWS               |  6 +++++\r
  81 >  configure          | 20 +++--------------\r
  82 >  doc/INSTALL        | 13 -----------\r
  83 >  doc/Makefile.local |  7 ++----\r
  84 >  doc/prerst2man.py  | 64\r
  85 ------------------------------------------------------\r
  86 >  6 files changed, 13 insertions(+), 104 deletions(-)\r
  87 >  delete mode 100644 doc/prerst2man.py\r
  88 >\r
  89 > diff --git a/INSTALL b/INSTALL\r
  90 > index b543c50..eaccd93 100644\r
  91 > --- a/INSTALL\r
  92 > +++ b/INSTALL\r
  93 > @@ -75,14 +75,11 @@ Talloc, and zlib which are each described below:\r
  94 >  Building Documentation\r
  95 >  ----------------------\r
  96 >\r
  97 > -By default the documentation for notmuch is built using sphinx.\r
  98 > +To build the documentation for notmuch you need at least version 1.0\r
  99 > +of sphinx (Jul. 2010).\r
 100 >\r
 101 >  Sphinx is available from www.sphinx-doc.org.\r
 102 >\r
 103 > -If you prefer, you can build the man pages using rst2man, from the\r
 104 > -python docutils package. See doc/INSTALL for details.\r
 105 > -\r
 106 > -\r
 107 >  Installing Dependencies from Packages\r
 108 >  -------------------------------------\r
 109 >\r
 110 > diff --git a/NEWS b/NEWS\r
 111 > index abb5ad7..53e06aa 100644\r
 112 > --- a/NEWS\r
 113 > +++ b/NEWS\r
 114 > @@ -1,5 +1,11 @@\r
 115 >  Notmuch 0.20 (UNRELEASED)\r
 116 >\r
 117 > +Documentation\r
 118 > +-------------\r
 119 > +\r
 120 > +Support for using rst2man in place of sphinx to build the\r
 121 > +docmumentation has been removed.\r
 122 \r
 123 -mu\r
 124 \r
 125 Otherwise lgtm.\r
 126 \r
 127 Jani.\r
 128 \r
 129 > +\r
 130 >  Contrib\r
 131 >  -------\r
 132 >\r
 133 > diff --git a/configure b/configure\r
 134 > index 137acea..a6b49ae 100755\r
 135 > --- a/configure\r
 136 > +++ b/configure\r
 137 > @@ -447,19 +447,9 @@ printf "Checking if sphinx is available and supports\r
 138 nroff output... "\r
 139 >  if hash sphinx-build > /dev/null 2>&1 && ${python} -m\r
 140 sphinx.writers.manpage > /dev/null 2>&1 ; then\r
 141 >      printf "Yes.\n"\r
 142 >      have_sphinx=1\r
 143 > -    have_rst2man=0\r
 144 >  else\r
 145 > -    printf "No (falling back to rst2man).\n"\r
 146 > +    printf "No (so will not install man pages).\n"\r
 147 >      have_sphinx=0\r
 148 > -\r
 149 > -    printf "Checking if rst2man is available... "\r
 150 > -    if rst2man -V > /dev/null 2>&1; then\r
 151 > -       printf "Yes.\n"\r
 152 > -       have_rst2man=1\r
 153 > -    else\r
 154 > -       printf "No (so will not install man pages).\n"\r
 155 > -       have_rst2man=0\r
 156 > -    fi\r
 157 >  fi\r
 158 >\r
 159 >  libdir_in_ldconfig=0\r
 160 > @@ -848,9 +838,6 @@ HAVE_EMACS = ${have_emacs}\r
 161 >  # Whether there's a sphinx-build binary available for building\r
 162 documentation\r
 163 >  HAVE_SPHINX=${have_sphinx}\r
 164 >\r
 165 > -# Whether there's a rst2man binary available for building documentation\r
 166 > -HAVE_RST2MAN=${have_rst2man}\r
 167 > -\r
 168 >  # Whether there's a doxygen binary available for building api\r
 169 documentation\r
 170 >  HAVE_DOXYGEN=${have_doxygen}\r
 171 >\r
 172 > @@ -978,9 +965,8 @@ cat > sh.config <<EOF\r
 173 >  # Whether the Xapian version in use supports compaction\r
 174 >  NOTMUCH_HAVE_XAPIAN_COMPACT=${have_xapian_compact}\r
 175 >\r
 176 > -# Whether there's either sphinx or rst2man available for building\r
 177 > -# documentation\r
 178 > -NOTMUCH_HAVE_MAN=$((have_sphinx || have_rst2man))\r
 179 > +# do we have man pages?\r
 180 > +NOTMUCH_HAVE_MAN=$((have_sphinx))\r
 181 >\r
 182 >  # Name of python interpreter\r
 183 >  NOTMUCH_PYTHON=${python}\r
 184 > diff --git a/doc/INSTALL b/doc/INSTALL\r
 185 > index e37c2b9..0585476 100644\r
 186 > --- a/doc/INSTALL\r
 187 > +++ b/doc/INSTALL\r
 188 > @@ -1,9 +1,6 @@\r
 189 >  This file contains some more detailed information about building and\r
 190 >  installing the documentation.\r
 191 >\r
 192 > -Building with sphinx.\r
 193 > ----------------------\r
 194 > -\r
 195 >  - You need sphinx at least version 1.0.\r
 196 >\r
 197 >  - You can build build and install man pages with 'make install-man'\r
 198 > @@ -12,13 +9,3 @@ Building with sphinx.\r
 199 >    (currently only the man pages) with\r
 200 >\r
 201 >       'make install-{man|info|html|pdf}'\r
 202 > -\r
 203 > -Building the man pages\r
 204 > -----------------------\r
 205 > -\r
 206 > -- You can build the man pages with rst2man (from python-docutils) with\r
 207 > -  'make rst2man'.\r
 208 > -\r
 209 > -- Currently there is no support to automagically install the resulting\r
 210 > -  nroff files, but it should work to modify the target install-man\r
 211 > -  in doc/Makefile.local.\r
 212 > diff --git a/doc/Makefile.local b/doc/Makefile.local\r
 213 > index e7d0bac..0bdf2e1 100644\r
 214 > --- a/doc/Makefile.local\r
 215 > +++ b/doc/Makefile.local\r
 216 > @@ -7,7 +7,6 @@ SPHINXOPTS    := -q\r
 217 >  SPHINXBUILD   = sphinx-build\r
 218 >  DOCBUILDDIR      := $(dir)/_build\r
 219 >\r
 220 > -prerst2man := python $(srcdir)/$(dir)/prerst2man.py\r
 221 >  mkdocdeps := python $(srcdir)/$(dir)/mkdocdeps.py\r
 222 >\r
 223 >  # Internal variables.\r
 224 > @@ -50,8 +49,6 @@ ifeq ($(HAVE_SPHINX),1)\r
 225 >             mkdir -p $(DOCBUILDDIR)/man/man$${section}; \\r
 226 >             mv $(DOCBUILDDIR)/man/*.$${section}\r
 227 $(DOCBUILDDIR)/man/man$${section}; \\r
 228 >         done\r
 229 > -else ifeq ($(HAVE_RST2MAN),1)\r
 230 > -       $(prerst2man) $(srcdir)/doc $(DOCBUILDDIR)/man\r
 231 >  else\r
 232 >         @echo "Fatal: build dependency fail."\r
 233 >         @false\r
 234 > @@ -79,10 +76,10 @@ endif\r
 235 >\r
 236 >  # Do not try to build or install man pages if a man page converter is\r
 237 >  # not available.\r
 238 > -ifeq ($(HAVE_SPHINX)$(HAVE_RST2MAN),00)\r
 239 > +ifeq ($(HAVE_SPHINX),0)\r
 240 >  build-man:\r
 241 >  install-man:\r
 242 > -       @echo "No sphinx or rst2man, will not install man pages."\r
 243 > +       @echo "No sphinx, will not install man pages."\r
 244 >  else\r
 245 >  build-man: ${MAN_GZIP_FILES}\r
 246 >  install-man: ${MAN_GZIP_FILES}\r
 247 > diff --git a/doc/prerst2man.py b/doc/prerst2man.py\r
 248 > deleted file mode 100644\r
 249 > index 968722a..0000000\r
 250 > --- a/doc/prerst2man.py\r
 251 > +++ /dev/null\r
 252 > @@ -1,64 +0,0 @@\r
 253 > -from sys import argv\r
 254 > -from datetime import date\r
 255 > -from os.path import dirname, isdir\r
 256 > -from os import makedirs, system\r
 257 > -import re\r
 258 > -\r
 259 > -sourcedir = argv[1]\r
 260 > -outdir = argv[2]\r
 261 > -\r
 262 > -if not isdir(outdir):\r
 263 > -    makedirs(outdir, 0o755)\r
 264 > -\r
 265 > -with open(sourcedir + "/conf.py") as cf:\r
 266 > -    exec(cf.read())\r
 267 > -\r
 268 > -\r
 269 > -def header(file, startdocname, command, description, authors, section):\r
 270 > -    file.write("""\r
 271 > -{0:s}\r
 272 > -{1:s}\r
 273 > -{2:s}\r
 274 > -\r
 275 > -:Date:   {3:s}\r
 276 > -:Version: {4:s}\r
 277 > -:Manual section: {5:d}\r
 278 > -:Manual group: {6:s}\r
 279 > -\r
 280 > -""".format(\r
 281 > -'-' * len(description),\r
 282 > -description,\r
 283 > -'-' * len(description),\r
 284 > -date.today().isoformat(), release, section, project))\r
 285 > -\r
 286 > -blankre = re.compile("^\s*$")\r
 287 > -for page in man_pages:\r
 288 > -    outdirname = outdir + '/' + dirname(page[0])\r
 289 > -    if not isdir(outdirname):\r
 290 > -        makedirs(outdirname, 0o755)\r
 291 > -    filename = outdir + '/' + page[0] + '.rst'\r
 292 > -    outfile = open(filename, 'w')\r
 293 > -    infile = open(sourcedir + '/' + page[0] + '.rst', 'r')\r
 294 > -\r
 295 > -    # this is a crude hack. We look for the first blank line, and\r
 296 > -    # insert the rst2man header there.\r
 297 > -    #\r
 298 > -    # XXX consider really parsing input\r
 299 > -\r
 300 > -    count = 0\r
 301 > -    lines = infile.readlines()\r
 302 > -    for line in lines:\r
 303 > -        outfile.write(line)\r
 304 > -        if (blankre.match(line)):\r
 305 > -            break\r
 306 > -        count = count + 1\r
 307 > -\r
 308 > -    del lines[0:count + 1]\r
 309 > -\r
 310 > -    header(outfile, *page)\r
 311 > -\r
 312 > -    outfile.write("".join(lines))\r
 313 > -    outfile.close()\r
 314 > -\r
 315 > -    system('set -x; rst2man {0} {1}/{2}.{3}'\r
 316 > -           .format(filename, outdir, page[0], page[4]))\r
 317 > --\r
 318 > 2.1.4\r
 319 >\r
 320 > _______________________________________________\r
 321 > notmuch mailing list\r
 322 > notmuch@notmuchmail.org\r
 323 > http://notmuchmail.org/mailman/listinfo/notmuch\r
 324 \r
 325 --047d7b874450e78936050cf26f93\r
 326 Content-Type: text/html; charset=UTF-8\r
 327 Content-Transfer-Encoding: quoted-printable\r
 328 \r
 329 <p dir=3D"ltr"><br>\r
 330 On Jan 18, 2015 6:56 PM, &quot;David Bremner&quot; &lt;<a href=3D"mailto:da=\r
 331 vid@tethera.net">david@tethera.net</a>&gt; wrote:<br>\r
 332 &gt;<br>\r
 333 &gt; It was becoming increasingly complicated to support rst2man, and there=\r
 334 <br>\r
 335 &gt; were apparently not many people that relied on it.<br>\r
 336 &gt; ---<br>\r
 337 &gt;<br>\r
 338 &gt; Now&#39;s your chance to tell us how useful rst2man support is to you.=\r
 339 <br>\r
 340 &gt;<br>\r
 341 &gt; =C2=A0INSTALL=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 |=C2=A0 7 ++---=\r
 342 -<br>\r
 343 &gt; =C2=A0NEWS=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0|=C2=\r
 344 =A0 6 +++++<br>\r
 345 &gt; =C2=A0configure=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 | 20 +++------------=\r
 346 --<br>\r
 347 &gt; =C2=A0doc/INSTALL=C2=A0 =C2=A0 =C2=A0 =C2=A0 | 13 -----------<br>\r
 348 &gt; =C2=A0doc/Makefile.local |=C2=A0 7 ++----<br>\r
 349 &gt; =C2=A0doc/prerst2man.py=C2=A0 | 64 -----------------------------------=\r
 350 -------------------<br>\r
 351 &gt; =C2=A06 files changed, 13 insertions(+), 104 deletions(-)<br>\r
 352 &gt; =C2=A0delete mode 100644 doc/prerst2man.py<br>\r
 353 &gt;<br>\r
 354 &gt; diff --git a/INSTALL b/INSTALL<br>\r
 355 &gt; index b543c50..eaccd93 100644<br>\r
 356 &gt; --- a/INSTALL<br>\r
 357 &gt; +++ b/INSTALL<br>\r
 358 &gt; @@ -75,14 +75,11 @@ Talloc, and zlib which are each described below:<b=\r
 359 r>\r
 360 &gt; =C2=A0Building Documentation<br>\r
 361 &gt; =C2=A0----------------------<br>\r
 362 &gt;<br>\r
 363 &gt; -By default the documentation for notmuch is built using sphinx.<br>\r
 364 &gt; +To build the documentation for notmuch you need at least version 1.0<=\r
 365 br>\r
 366 &gt; +of sphinx (Jul. 2010).<br>\r
 367 &gt;<br>\r
 368 &gt; =C2=A0Sphinx is available from <a href=3D"http://www.sphinx-doc.org">w=\r
 369 ww.sphinx-doc.org</a>.<br>\r
 370 &gt;<br>\r
 371 &gt; -If you prefer, you can build the man pages using rst2man, from the<br=\r
 372 >\r
 373 &gt; -python docutils package. See doc/INSTALL for details.<br>\r
 374 &gt; -<br>\r
 375 &gt; -<br>\r
 376 &gt; =C2=A0Installing Dependencies from Packages<br>\r
 377 &gt; =C2=A0-------------------------------------<br>\r
 378 &gt;<br>\r
 379 &gt; diff --git a/NEWS b/NEWS<br>\r
 380 &gt; index abb5ad7..53e06aa 100644<br>\r
 381 &gt; --- a/NEWS<br>\r
 382 &gt; +++ b/NEWS<br>\r
 383 &gt; @@ -1,5 +1,11 @@<br>\r
 384 &gt; =C2=A0Notmuch 0.20 (UNRELEASED)<br>\r
 385 &gt;<br>\r
 386 &gt; +Documentation<br>\r
 387 &gt; +-------------<br>\r
 388 &gt; +<br>\r
 389 &gt; +Support for using rst2man in place of sphinx to build the<br>\r
 390 &gt; +docmumentation has been removed.</p>\r
 391 <p dir=3D"ltr">-mu</p>\r
 392 <p dir=3D"ltr">Otherwise lgtm.</p>\r
 393 <p dir=3D"ltr">Jani.<br></p>\r
 394 <p dir=3D"ltr">&gt; +<br>\r
 395 &gt; =C2=A0Contrib<br>\r
 396 &gt; =C2=A0-------<br>\r
 397 &gt;<br>\r
 398 &gt; diff --git a/configure b/configure<br>\r
 399 &gt; index 137acea..a6b49ae 100755<br>\r
 400 &gt; --- a/configure<br>\r
 401 &gt; +++ b/configure<br>\r
 402 &gt; @@ -447,19 +447,9 @@ printf &quot;Checking if sphinx is available and =\r
 403 supports nroff output... &quot;<br>\r
 404 &gt; =C2=A0if hash sphinx-build &gt; /dev/null 2&gt;&amp;1 &amp;&amp; ${pyt=\r
 405 hon} -m sphinx.writers.manpage &gt; /dev/null 2&gt;&amp;1 ; then<br>\r
 406 &gt; =C2=A0 =C2=A0 =C2=A0printf &quot;Yes.\n&quot;<br>\r
 407 &gt; =C2=A0 =C2=A0 =C2=A0have_sphinx=3D1<br>\r
 408 &gt; -=C2=A0 =C2=A0 have_rst2man=3D0<br>\r
 409 &gt; =C2=A0else<br>\r
 410 &gt; -=C2=A0 =C2=A0 printf &quot;No (falling back to rst2man).\n&quot;<br>\r
 411 &gt; +=C2=A0 =C2=A0 printf &quot;No (so will not install man pages).\n&quot=\r
 412 ;<br>\r
 413 &gt; =C2=A0 =C2=A0 =C2=A0have_sphinx=3D0<br>\r
 414 &gt; -<br>\r
 415 &gt; -=C2=A0 =C2=A0 printf &quot;Checking if rst2man is available... &quot;=\r
 416 <br>\r
 417 &gt; -=C2=A0 =C2=A0 if rst2man -V &gt; /dev/null 2&gt;&amp;1; then<br>\r
 418 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0printf &quot;Yes.\n&quot;<br>\r
 419 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0have_rst2man=3D1<br>\r
 420 &gt; -=C2=A0 =C2=A0 else<br>\r
 421 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0printf &quot;No (so will not install man p=\r
 422 ages).\n&quot;<br>\r
 423 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0have_rst2man=3D0<br>\r
 424 &gt; -=C2=A0 =C2=A0 fi<br>\r
 425 &gt; =C2=A0fi<br>\r
 426 &gt;<br>\r
 427 &gt; =C2=A0libdir_in_ldconfig=3D0<br>\r
 428 &gt; @@ -848,9 +838,6 @@ HAVE_EMACS =3D ${have_emacs}<br>\r
 429 &gt; =C2=A0# Whether there&#39;s a sphinx-build binary available for buildi=\r
 430 ng documentation<br>\r
 431 &gt; =C2=A0HAVE_SPHINX=3D${have_sphinx}<br>\r
 432 &gt;<br>\r
 433 &gt; -# Whether there&#39;s a rst2man binary available for building documen=\r
 434 tation<br>\r
 435 &gt; -HAVE_RST2MAN=3D${have_rst2man}<br>\r
 436 &gt; -<br>\r
 437 &gt; =C2=A0# Whether there&#39;s a doxygen binary available for building ap=\r
 438 i documentation<br>\r
 439 &gt; =C2=A0HAVE_DOXYGEN=3D${have_doxygen}<br>\r
 440 &gt;<br>\r
 441 &gt; @@ -978,9 +965,8 @@ cat &gt; sh.config &lt;&lt;EOF<br>\r
 442 &gt; =C2=A0# Whether the Xapian version in use supports compaction<br>\r
 443 &gt; =C2=A0NOTMUCH_HAVE_XAPIAN_COMPACT=3D${have_xapian_compact}<br>\r
 444 &gt;<br>\r
 445 &gt; -# Whether there&#39;s either sphinx or rst2man available for building=\r
 446 <br>\r
 447 &gt; -# documentation<br>\r
 448 &gt; -NOTMUCH_HAVE_MAN=3D$((have_sphinx || have_rst2man))<br>\r
 449 &gt; +# do we have man pages?<br>\r
 450 &gt; +NOTMUCH_HAVE_MAN=3D$((have_sphinx))<br>\r
 451 &gt;<br>\r
 452 &gt; =C2=A0# Name of python interpreter<br>\r
 453 &gt; =C2=A0NOTMUCH_PYTHON=3D${python}<br>\r
 454 &gt; diff --git a/doc/INSTALL b/doc/INSTALL<br>\r
 455 &gt; index e37c2b9..0585476 100644<br>\r
 456 &gt; --- a/doc/INSTALL<br>\r
 457 &gt; +++ b/doc/INSTALL<br>\r
 458 &gt; @@ -1,9 +1,6 @@<br>\r
 459 &gt; =C2=A0This file contains some more detailed information about building=\r
 460  and<br>\r
 461 &gt; =C2=A0installing the documentation.<br>\r
 462 &gt;<br>\r
 463 &gt; -Building with sphinx.<br>\r
 464 &gt; ----------------------<br>\r
 465 &gt; -<br>\r
 466 &gt; =C2=A0- You need sphinx at least version 1.0.<br>\r
 467 &gt;<br>\r
 468 &gt; =C2=A0- You can build build and install man pages with &#39;make insta=\r
 469 ll-man&#39;<br>\r
 470 &gt; @@ -12,13 +9,3 @@ Building with sphinx.<br>\r
 471 &gt; =C2=A0 =C2=A0(currently only the man pages) with<br>\r
 472 &gt;<br>\r
 473 &gt; =C2=A0 =C2=A0 =C2=A0 &#39;make install-{man|info|html|pdf}&#39;<br>\r
 474 &gt; -<br>\r
 475 &gt; -Building the man pages<br>\r
 476 &gt; -----------------------<br>\r
 477 &gt; -<br>\r
 478 &gt; -- You can build the man pages with rst2man (from python-docutils) wit=\r
 479 h<br>\r
 480 &gt; -=C2=A0 &#39;make rst2man&#39;.<br>\r
 481 &gt; -<br>\r
 482 &gt; -- Currently there is no support to automagically install the resultin=\r
 483 g<br>\r
 484 &gt; -=C2=A0 nroff files, but it should work to modify the target install-m=\r
 485 an<br>\r
 486 &gt; -=C2=A0 in doc/Makefile.local.<br>\r
 487 &gt; diff --git a/doc/Makefile.local b/doc/Makefile.local<br>\r
 488 &gt; index e7d0bac..0bdf2e1 100644<br>\r
 489 &gt; --- a/doc/Makefile.local<br>\r
 490 &gt; +++ b/doc/Makefile.local<br>\r
 491 &gt; @@ -7,7 +7,6 @@ SPHINXOPTS=C2=A0 =C2=A0 :=3D -q<br>\r
 492 &gt; =C2=A0SPHINXBUILD=C2=A0 =C2=A0=3D sphinx-build<br>\r
 493 &gt; =C2=A0DOCBUILDDIR=C2=A0 =C2=A0 =C2=A0 :=3D $(dir)/_build<br>\r
 494 &gt;<br>\r
 495 &gt; -prerst2man :=3D python $(srcdir)/$(dir)/prerst2man.py<br>\r
 496 &gt; =C2=A0mkdocdeps :=3D python $(srcdir)/$(dir)/mkdocdeps.py<br>\r
 497 &gt;<br>\r
 498 &gt; =C2=A0# Internal variables.<br>\r
 499 &gt; @@ -50,8 +49,6 @@ ifeq ($(HAVE_SPHINX),1)<br>\r
 500 &gt; =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 mkdir -p $(DOCBUILDDIR)/man/=\r
 501 man$${section}; \<br>\r
 502 &gt; =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 mv $(DOCBUILDDIR)/man/*.$${s=\r
 503 ection} $(DOCBUILDDIR)/man/man$${section}; \<br>\r
 504 &gt; =C2=A0 =C2=A0 =C2=A0 =C2=A0 done<br>\r
 505 &gt; -else ifeq ($(HAVE_RST2MAN),1)<br>\r
 506 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0$(prerst2man) $(srcdir)/doc $(DOCBUILDDIR)=\r
 507 /man<br>\r
 508 &gt; =C2=A0else<br>\r
 509 &gt; =C2=A0 =C2=A0 =C2=A0 =C2=A0 @echo &quot;Fatal: build dependency fail.&=\r
 510 quot;<br>\r
 511 &gt; =C2=A0 =C2=A0 =C2=A0 =C2=A0 @false<br>\r
 512 &gt; @@ -79,10 +76,10 @@ endif<br>\r
 513 &gt;<br>\r
 514 &gt; =C2=A0# Do not try to build or install man pages if a man page convert=\r
 515 er is<br>\r
 516 &gt; =C2=A0# not available.<br>\r
 517 &gt; -ifeq ($(HAVE_SPHINX)$(HAVE_RST2MAN),00)<br>\r
 518 &gt; +ifeq ($(HAVE_SPHINX),0)<br>\r
 519 &gt; =C2=A0build-man:<br>\r
 520 &gt; =C2=A0install-man:<br>\r
 521 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0@echo &quot;No sphinx or rst2man, will not=\r
 522  install man pages.&quot;<br>\r
 523 &gt; +=C2=A0 =C2=A0 =C2=A0 =C2=A0@echo &quot;No sphinx, will not install ma=\r
 524 n pages.&quot;<br>\r
 525 &gt; =C2=A0else<br>\r
 526 &gt; =C2=A0build-man: ${MAN_GZIP_FILES}<br>\r
 527 &gt; =C2=A0install-man: ${MAN_GZIP_FILES}<br>\r
 528 &gt; diff --git a/doc/prerst2man.py b/doc/prerst2man.py<br>\r
 529 &gt; deleted file mode 100644<br>\r
 530 &gt; index 968722a..0000000<br>\r
 531 &gt; --- a/doc/prerst2man.py<br>\r
 532 &gt; +++ /dev/null<br>\r
 533 &gt; @@ -1,64 +0,0 @@<br>\r
 534 &gt; -from sys import argv<br>\r
 535 &gt; -from datetime import date<br>\r
 536 &gt; -from os.path import dirname, isdir<br>\r
 537 &gt; -from os import makedirs, system<br>\r
 538 &gt; -import re<br>\r
 539 &gt; -<br>\r
 540 &gt; -sourcedir =3D argv[1]<br>\r
 541 &gt; -outdir =3D argv[2]<br>\r
 542 &gt; -<br>\r
 543 &gt; -if not isdir(outdir):<br>\r
 544 &gt; -=C2=A0 =C2=A0 makedirs(outdir, 0o755)<br>\r
 545 &gt; -<br>\r
 546 &gt; -with open(sourcedir + &quot;/conf.py&quot;) as cf:<br>\r
 547 &gt; -=C2=A0 =C2=A0 exec(cf.read())<br>\r
 548 &gt; -<br>\r
 549 &gt; -<br>\r
 550 &gt; -def header(file, startdocname, command, description, authors, section=\r
 551 ):<br>\r
 552 &gt; -=C2=A0 =C2=A0 file.write(&quot;&quot;&quot;<br>\r
 553 &gt; -{0:s}<br>\r
 554 &gt; -{1:s}<br>\r
 555 &gt; -{2:s}<br>\r
 556 &gt; -<br>\r
 557 &gt; -:Date:=C2=A0 =C2=A0{3:s}<br>\r
 558 &gt; -:Version: {4:s}<br>\r
 559 &gt; -:Manual section: {5:d}<br>\r
 560 &gt; -:Manual group: {6:s}<br>\r
 561 &gt; -<br>\r
 562 &gt; -&quot;&quot;&quot;.format(<br>\r
 563 &gt; -&#39;-&#39; * len(description),<br>\r
 564 &gt; -description,<br>\r
 565 &gt; -&#39;-&#39; * len(description),<br>\r
 566 &gt; -date.today().isoformat(), release, section, project))<br>\r
 567 &gt; -<br>\r
 568 &gt; -blankre =3D re.compile(&quot;^\s*$&quot;)<br>\r
 569 &gt; -for page in man_pages:<br>\r
 570 &gt; -=C2=A0 =C2=A0 outdirname =3D outdir + &#39;/&#39; + dirname(page[0])<=\r
 571 br>\r
 572 &gt; -=C2=A0 =C2=A0 if not isdir(outdirname):<br>\r
 573 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0 makedirs(outdirname, 0o755)<br>\r
 574 &gt; -=C2=A0 =C2=A0 filename =3D outdir + &#39;/&#39; + page[0] + &#39;.rst=\r
 575 &#39;<br>\r
 576 &gt; -=C2=A0 =C2=A0 outfile =3D open(filename, &#39;w&#39;)<br>\r
 577 &gt; -=C2=A0 =C2=A0 infile =3D open(sourcedir + &#39;/&#39; + page[0] + &#3=\r
 578 9;.rst&#39;, &#39;r&#39;)<br>\r
 579 &gt; -<br>\r
 580 &gt; -=C2=A0 =C2=A0 # this is a crude hack. We look for the first blank lin=\r
 581 e, and<br>\r
 582 &gt; -=C2=A0 =C2=A0 # insert the rst2man header there.<br>\r
 583 &gt; -=C2=A0 =C2=A0 #<br>\r
 584 &gt; -=C2=A0 =C2=A0 # XXX consider really parsing input<br>\r
 585 &gt; -<br>\r
 586 &gt; -=C2=A0 =C2=A0 count =3D 0<br>\r
 587 &gt; -=C2=A0 =C2=A0 lines =3D infile.readlines()<br>\r
 588 &gt; -=C2=A0 =C2=A0 for line in lines:<br>\r
 589 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0 outfile.write(line)<br>\r
 590 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0 if (blankre.match(line)):<br>\r
 591 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 break<br>\r
 592 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0 count =3D count + 1<br>\r
 593 &gt; -<br>\r
 594 &gt; -=C2=A0 =C2=A0 del lines[0:count + 1]<br>\r
 595 &gt; -<br>\r
 596 &gt; -=C2=A0 =C2=A0 header(outfile, *page)<br>\r
 597 &gt; -<br>\r
 598 &gt; -=C2=A0 =C2=A0 outfile.write(&quot;&quot;.join(lines))<br>\r
 599 &gt; -=C2=A0 =C2=A0 outfile.close()<br>\r
 600 &gt; -<br>\r
 601 &gt; -=C2=A0 =C2=A0 system(&#39;set -x; rst2man {0} {1}/{2}.{3}&#39;<br>\r
 602 &gt; -=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0.format(filename, outdir, pa=\r
 603 ge[0], page[4]))<br>\r
 604 &gt; --<br>\r
 605 &gt; 2.1.4<br>\r
 606 &gt;<br>\r
 607 &gt; _______________________________________________<br>\r
 608 &gt; notmuch mailing list<br>\r
 609 &gt; <a href=3D"mailto:notmuch@notmuchmail.org">notmuch@notmuchmail.org</a>=\r
 610 <br>\r
 611 &gt; <a href=3D"http://notmuchmail.org/mailman/listinfo/notmuch">http://not=\r
 612 muchmail.org/mailman/listinfo/notmuch</a><br>\r
 613 </p>\r
 614 \r
 615 --047d7b874450e78936050cf26f93--\r