CDRIVER-1979 build docs with sphinx-build

Author: ajdavis

build/autotools/CheckProgs.m4

@@ -16,7 +16,7 @@ fi
 AC_CHECK_HEADERS_ONCE([strings.h])
 
 # Optional for documentation
-AC_PATH_PROG(YELP_BUILD, yelp-build)
+AC_PATH_PROG(SPHINX_BUILD, sphinx-build)
 
 AC_PROG_INSTALL
 

build/autotools/ReadCommandLineArguments.m4

@@ -96,12 +96,6 @@ AC_ARG_ENABLE([man-pages],
               [],
               [enable_man_pages=no])
 
-AC_ARG_ENABLE([yelp],
-              [AS_HELP_STRING([--enable-yelp=@<:@yes/no@:>@],
-                              [Install yelp manuals.])],
-              [],
-              [enable_yelp=no])
-
 AC_ARG_ENABLE([examples],
               [AS_HELP_STRING([--enable-examples=@<:@yes/no@:>@],
                               [Build MongoDB C Driver examples.])],

build/autotools/SetupAutomake.m4

@@ -37,8 +37,10 @@ AM_CONDITIONAL([ENABLE_TESTS],[test "$enable_tests" = "yes"])
 
 # Should we build man pages
 AM_CONDITIONAL([ENABLE_MAN_PAGES],[test "$enable_man_pages" = "yes"])
+AS_IF([test "$enable_man_pages" = "yes" && test -z "$SPHINX_BUILD"],
+      [AC_MSG_ERROR([The Sphinx Python package must be installed to generate man pages.])])
 
 # Should we build HTML documentation
 AM_CONDITIONAL([ENABLE_HTML_DOCS],[test "$enable_html_docs" = "yes"])
-AS_IF([test "$enable_html_docs" = "yes" && test -z "$YELP_BUILD"],
-      [AC_MSG_ERROR([yelp-build must be installed to generate HTML documentation.])])
+AS_IF([test "$enable_html_docs" = "yes" && test -z "$SPHINX_BUILD"],
+      [AC_MSG_ERROR([The Sphinx Python package must be installed to generate HTML documentation.])])

build/libmongoc.xsl

@@ -56,13 +56,10 @@ m4_include([build/autotools/SetupAutomake.m4])
 
 AC_CONFIG_FILES([
     Makefile
-    build/version
     src/libmongoc-1.0.pc
     src/libmongoc-ssl-1.0.pc
     src/mongoc/mongoc-config.h
     src/mongoc/mongoc-version.h
-    doc/mongoc_installing.page
-    doc/mongoc_version.page
 ])
 
 m4_include([build/autotools/Libbson.m4])

build/version.in

@@ -11,5 +11,3 @@ html/_static
 html/.buildinfo
 html/.nojekyll
 man/*.3
-mongoc_installing.page
-mongoc_version.page

build/version.xml

@@ -1,3 +1 @@
-EXTRA_DIST += doc/mallard2man.py build/libmongoc.xsl build/version.xml
-
 dist-hook: man html

configure.ac

@@ -5,22 +5,37 @@ CLEANFILES += $(wildcard doc/html/*.png)
 
 .PHONY: doc/html
 
+# "E" is "ignore cache", and "d" sets the dir to save cachefiles in.
 doc/html:
 	-mkdir -p doc/html
-	$(AM_V_GEN)$(YELP_BUILD) html -x $(top_srcdir)/build/libmongoc.xsl -o doc/html/ doc
+	$(SPHINX_BUILD) -qEW -d /tmp/sphinx-cache-dir doc doc/html
 
-YELP_HTML_FILES = \
-	doc/html/C.css \
-	doc/html/jquery.js \
-	doc/html/jquery.syntax.brush.clang.js \
-	doc/html/jquery.syntax.core.js \
-	doc/html/jquery.syntax.js \
-	doc/html/jquery.syntax.layout.yelp.js \
-	doc/html/yelp-note-tip.png \
-	doc/html/yelp-note-warning.png \
-	doc/html/yelp-note.png \
-	doc/html/yelp.js
+SPHINX_HTML_FILES = \
+   doc/html/.nojekyll \
+   doc/html/_static \
+   doc/html/_static/ajax-loader.gif \
+   doc/html/_static/basic.css \
+   doc/html/_static/comment-bright.png \
+   doc/html/_static/comment-close.png \
+   doc/html/_static/comment.png \
+   doc/html/_static/doctools.js \
+   doc/html/_static/down-pressed.png \
+   doc/html/_static/down.png \
+   doc/html/_static/file.png \
+   doc/html/_static/jquery-3.1.0.js \
+   doc/html/_static/jquery.js \
+   doc/html/_static/minus.png \
+   doc/html/_static/mongoc.css \
+   doc/html/_static/plus.png \
+   doc/html/_static/pygments.css \
+   doc/html/_static/searchtools.js \
+   doc/html/_static/underscore-1.3.1.js \
+   doc/html/_static/underscore.js \
+   doc/html/_static/up-pressed.png \
+   doc/html/_static/up.png \
+   doc/html/_static/websupport.js \
+   doc/html/objects.inv \
+   doc/html/searchindex.js
 
 EXTRA_DIST += doc/html
-EXTRA_DIST += $(YELP_HTML_FILES)
-
+EXTRA_DIST += $(SPHINX_HTML_FILES)