Lintian Reports

W package-contains-python-doctree-file

All reports of package-contains-python-doctree-file for the archive. The extended description of this tag is:

This package appears to contain a pickled cache of reStructuredText (*.rst) documentation in a .doctree file.

These are not needed to display the documentation correctly and as they can contain absolute build paths can affect the reproducibility of the package.

Either prevent the installation of the .doctree file (or parent doctrees directory if there is one) or pass the -d option to sphinx-build(1) to create the caches elsewhere.

For example:

      override_dh_auto_build:
              dh_auto_build
              PYTHONPATH=. sphinx-build -bman docs/ -d debian/doctrees docs/build/html
              PYTHONPATH=. sphinx-build -bhtml docs/ -d debian/doctrees docs/build/html
    
    
      override_dh_auto_clean:
              dh_auto_clean
              rm -rf debian/doctrees
    

Refer to http://sphinx-doc.org/invocation.html#cmdoption-sphinx-build-d for details.

Severity: normal, Certainty: certain

Check: files, Type: binary, udeb

This tag has not been emitted in any package tested by Lintian.