doc/conf.py | 19 17 2 - 0 !
1 file changed, 17 insertions( ), 2 deletions(-)

 use local object inventory files for sphinx

Use the local object inventory files to prevent sphinx-build from
downloading them during build.
This patch makes the intersphinx mappings depend on the existence of
these files, thus passing Debian Policy 12.3 while still maintaining
a level of comfort for the reader of the documentation.

doc/conf.py | 3 1 2 - 0 !
1 file changed, 1 insertion( ), 2 deletions(-)

 disable issue tracker integration during build.

Disable the issue tracker integration to allow the package to be built without
network access.

sphinxcontrib/issuetracker/resolvers.py | 10 8 2 - 0 !
1 file changed, 8 insertions( ), 2 deletions(-)

 handle importerror more gracefully

To assist users who do not install the Recommends, enhance the message for
ImportError exceptions related to those packages by giving hints on the
package names.

doc/index.rst | 4 1 3 - 0 !
1 file changed, 1 insertion( ), 3 deletions(-)

 remove license.txt from toc.

For Debian the license is shipped in the copyright file. It is not necessary to
ship it again as part of the HTML documentation. This patch removes the license
file from the TOC.

sphinxcontrib/issuetracker/__init__.py | 10 7 3 - 0 !
1 file changed, 7 insertions( ), 3 deletions(-)

 move css file out of python path.

This patch separates Python code from CSS by moving the issuetracker.css file
to an other path: /usr/share/sphinx/contrib/issuetracker/

sphinxcontrib/issuetracker/__init__.py | 1 1 0 - 0 !
1 file changed, 1 insertion( )

 set refdomain for refnodes to fix build with sphinx 1.6.3

Otherwise the documentation build fails with:

Traceback (most recent call last):
  [...]
  File "/usr/lib/python2.7/dist-packages/sphinx/environment/__init__.py", line 730, in read_doc
    domain.process_doc(self, docname, doctree)
  File "/usr/lib/python2.7/dist-packages/sphinx/domains/std.py", line 576, in process_doc
    self.note_citation_refs(env, docname, document)
  File "/usr/lib/python2.7/dist-packages/sphinx/domains/std.py", line 593, in note_citation_refs
    if node['refdomain'] == 'std' and node['reftype'] == 'citation':
  File "/usr/lib/python2.7/dist-packages/docutils/nodes.py", line 567, in __getitem__
    return self.attributes[key]
KeyError: 'refdomain'