doc: Add rst2html support for building HTML docs doc-build
authorW. Trevor King <wking@tremily.us>
Sat, 10 May 2014 16:40:55 +0000 (09:40 -0700)
committerW. Trevor King <wking@tremily.us>
Sat, 10 May 2014 16:49:23 +0000 (09:49 -0700)
commit5f852b5f1b0f84bb513d209b9ac1b731f2ec7fa8
tree181aebdbc3c311f253fd6ab6be333c717bb76bb1
parent4fb5447805a8d5bb8da74c0196f12ac4ffaf4394
doc: Add rst2html support for building HTML docs

We already fall back to rst2man if Sphinx isn't available for building
the man pages.  With this commit we'll fall back to rst2html for
building the HTML docs too.  The only tricky bit here is that
HAVE_SPHINX explicitly checks for sphinx.writers.manpage.  I'm just
assuming sphinx.writers.html exists, to avoid adding a separate
SPHINX_HTML variable.  However, the HTML builder is Sphinx's default,
so it's hard to imagine it not being installed :p.  Perhaps it would
be better to drop the HAVE_* settings and SPHINXBUILD to use:

* SPHINX2MAN empty for not-available, otherwise path to script that
  can handle '-b manpage'
* SPHINX2HTML empty for not-available, otherwise path to script that
  can handle '-b html'
* RST2MAN empty for not-available, otherwise path to script
* RST2HTML empty for not-available, otherwise path to script

I'm sticking with the less intrusive change for now, but I'm happy
with either approach.
configure
doc/INSTALL
doc/Makefile.local