Bug#751798: zope.deprecation: Generate documentation at package build time with sphinxdoc

[Barry Warsaw]

Source: zope.deprecation
Severity: normal

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Dear Maintainer,

The upstream tarball for zope.deprecation (as of 4.1.1) contains a
docs/_build directory with the pre-built html files.  This is
generally unacceptable for Debian, where it's more acceptable to
generate the documentation at package build time by using the
sphinxdoc helper, e.g.:

    dh $@ --with python2,python3,sphinxdoc --buildsystem=pybuild
    
Fixing this probably means omitting the docs/_build directory from the
original tarball, either through a d/copyright Files-Excluded header,
or by trimming it in a get-orig-source or with an
override_dh_sphinxdoc d/rules target.

See https://wiki.debian.org/Python/LibraryStyleGuide for further
details.


- -- System Information:
Debian Release: jessie/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 3.14-1-amd64 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQIcBAEBCAAGBQJTnzYsAAoJEBJutWOnSwa/eL8P+wV4yf4vkXO2mLAyw1Wscj0B
zp1zqwTZJWyjklJZbxGbaXebobe5ZU4TPblfBK+4wrXfr7v5aC2NlQHEx2VbgOh8
kLrZBlD57RC9YHShMoOdn6aqY9hy37l6M0JcCvY1ejwy45N+iCTWXxsxed3TEVk+
jZuXx75RxOH4pbp0aEdxrItjGx+MpcDeqjBJZe8Jx6ahuK28XLU+E7+9K6hiW4lL
kabIs2aWpdw/kjU6SfUo4KThaIwc8MUbj2I9x/fjK7qbYB4E9xny9vzOD2XuO1nO
X6hvrW2iLTdALF3b3cul+TreYPb6pzevdXyXViBw4as5BJ1dk/15PhwjiaDxRzMN
gWfjZFDV6K/COC4DKfMXoS6v0uSBa48J/wgghKPxuBqPytYfdarp8DGrUylBfD4J
3ErJBBa2UAAJfKAUXs/qQGMKQQZQ6lqqaLLYby/tYUBCqsRSfX4E1XpQrAXrNlnq
8Lnujpq7hPtIwy8OkCrd9o3tDZi0ss0iKvtJszIjK+L1mzwM1bQvpxZzfSCGMtN2
Kk5F7zBQ/q+fq01eA54DBvn+bOGiOCsRe+vYGhQItjHMTyL9VWCqlvBNOw3RlITZ
UuBTD9Dx87ebWiC69mDWC+EYUcGyUALIMAtM1kiPCUi7T0d28KgyxEWc0agKwGZl
o6Cw5lUvaXRjpsUVuQ/y
=YONz
-----END PGP SIGNATURE-----