Merge pull request #2009 from kgaillot/doc

Convert "Pacemaker Development" to reStructuredText + sphinx

Author: Ken Gaillot

.gitignore

@@ -145,6 +145,8 @@ publican.cfg
 /doc/shared/en-US/*.xml
 /doc/shared/en-US/images/pcmk-*.png
 /doc/shared/en-US/images/Policy-Engine-*.png
+/doc/sphinx/*/_build
+/doc/sphinx/*/conf.py
 /lib/common/md5.c
 /maint/testcc
 /maint/mocked/based

INSTALL.md

@@ -46,6 +46,8 @@ Also: GNU make, and Python 2.7 or Python 3.2 or later
 | documentation                                   |                | publican                |                         | publican                |
 | documentation                                   |                | inkscape                | inkscape                | inkscape                |
 | documentation                                   |                | docbook-style-xsl       | docbook-xsl-stylesheets | docbook-xsl             |
+| documentation                                   |                | python-sphinx or python3-sphinx | python-sphinx or python3-sphinx | python-sphinx or python3-sphinx |
+| documentation (PDF)                             |                | texlive, texlive-titlesec, texlive-framed, texlive-threeparttable texlive-wrapfig texlive-multirow | texlive, texlive-latex  | texlive, texlive-latex-extra |
 
 ## Optional testing dependencies
 * valgrind (if running CTS valgrind tests)

configure.ac

@@ -681,6 +681,7 @@ esac
 AC_PATH_PROGS([ASCIIDOC_CONV], [asciidoc asciidoctor])
 AC_PATH_PROG([HELP2MAN], [help2man])
 AC_PATH_PROG([PUBLICAN], [publican])
+AC_PATH_PROG([SPHINX], [sphinx-build])
 AC_PATH_PROG([INKSCAPE], [inkscape])
 AC_PATH_PROG([XSLTPROC], [xsltproc])
 AC_PATH_PROG([XMLCATALOG], [xmlcatalog])
@@ -776,6 +777,8 @@ AM_CONDITIONAL([BUILD_DOCBOOK],
                 && test x"${INKSCAPE}" != x""])
 AM_CONDITIONAL([PUBLICAN_INTREE_BRAND],
                [test x"${publican_intree_brand}" = x"yes"])
+AM_CONDITIONAL([BUILD_SPHINX_DOCS],
+               [test x"${SPHINX}" != x""])
 
 dnl Pacemaker's shell scripts (and thus man page builders) rely on GNU getopt
 AC_MSG_CHECKING([for GNU-compatible getopt])
@@ -1978,6 +1981,7 @@ AC_CONFIG_FILES(Makefile                                            \
                 doc/Pacemaker_Development/publican.cfg              \
                 doc/Pacemaker_Explained/publican.cfg                \
                 doc/Pacemaker_Remote/publican.cfg                   \
+                doc/sphinx/Makefile                                 \
                 extra/Makefile                                      \
                 extra/alerts/Makefile                               \
                 extra/resources/Makefile                            \