Out-of-tree build for sphinx documents

The only drawback is that page source only contains include
directive. We disabled page source for now.

configure.ac

@@ -399,6 +399,12 @@ AC_CONFIG_FILES([
   python/Makefile
   doc/Makefile
   doc/conf.py
+  doc/index.rst
+  doc/package_README.rst
+  doc/tutorial-client.rst
+  doc/tutorial-server.rst
+  doc/nghttp2.h.rst
+  doc/nghttp2ver.h.rst
 ])
 AC_OUTPUT
 

doc/Makefile.am

@@ -79,7 +79,8 @@ help:
 
 apiref.rst: $(top_builddir)/lib/includes/nghttp2/nghttp2ver.h \
 	$(top_builddir)/lib/includes/nghttp2/nghttp2.h
-	$(PYTHON) $(builddir)/mkapiref.py --header apiref-header.rst $^ > $@
+	$(PYTHON) $(top_srcdir)/doc/mkapiref.py \
+	--header $(top_srcdir)/doc/apiref-header.rst $^ > $@
 
 clean:
 	-rm apiref.rst

doc/conf.py.in

@@ -51,7 +51,7 @@ import sys, os
 extensions = []
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ['@top_srcdir@/_templates']
 
 # The suffix of source filenames.
 source_suffix = '.rst'
@@ -87,7 +87,7 @@ release = '@PACKAGE_VERSION@'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['manual', 'README.rst', '*-header.rst']
+exclude_patterns = ['manual', 'README.rst', '*-header.rst', 'sources']
 
 # The reST default role (used for this markup: `text`) to use for all documents.
 default_role = 'c:func'
@@ -126,7 +126,7 @@ html_theme = 'sphinx_rtd_theme'
 #html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = ['_themes']
+html_theme_path = ['@top_srcdir@/doc/_themes']
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -177,7 +177,8 @@ html_sidebars = {
 #html_split_index = False
 
 # If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
+html_show_sourcelink = False
+html_copy_source = False
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
 #html_show_sphinx = True

doc/index.rst.in

+.. include:: @top_srcdir@/doc/sources/index.rst

doc/nghttp2.h.rst

-nghttp2.h
-=========
-
-.. literalinclude:: ../lib/includes/nghttp2/nghttp2.h

doc/nghttp2.h.rst.in

+nghttp2.h
+=========
+
+.. literalinclude:: @top_srcdir@/lib/includes/nghttp2/nghttp2.h

doc/nghttp2ver.h.rst

-nghttp2ver.h
-============
-
-.. literalinclude:: ../lib/includes/nghttp2/nghttp2ver.h

doc/nghttp2ver.h.rst.in

+nghttp2ver.h
+============
+
+.. literalinclude:: @top_builddir@/lib/includes/nghttp2/nghttp2ver.h

doc/package_README.rst

-.. include:: ../README.rst

doc/package_README.rst.in

+.. include:: @top_srcdir@/README.rst

doc/tutorial-client.rst → doc/sources/tutorial-client.rst

@@ -482,8 +482,3 @@ remote peer), we call `nghttp2_session_terminate_session()` to
 commencing the closure of the HTTP/2.0 session gracefully. If you have
 some data associated for the stream to be closed, you may delete it
 here.
-
-libevent-client.c
------------------
-
-.. literalinclude:: ../examples/libevent-client.c

doc/tutorial-server.rst → doc/sources/tutorial-server.rst

@@ -587,9 +587,3 @@ is about to close::
 
 We destroy ``http2_stream_data`` object in this function since the
 stream is about to close and we no longer use that object.
-
-
-libevent-server.c
------------------
-
-.. literalinclude:: ../examples/libevent-server.c

doc/tutorial-client.rst.in

+.. include:: @top_srcdir@/doc/sources/tutorial-client.rst
+
+libevent-client.c
+-----------------
+
+.. literalinclude:: @top_srcdir@/examples/libevent-client.c

doc/tutorial-server.rst.in

+.. include:: @top_srcdir@/doc/sources/tutorial-server.rst
+
+libevent-server.c
+-----------------
+
+.. literalinclude:: @top_srcdir@/examples/libevent-server.c