[Debian-astro-maintainers] Bug#1023147: python3-asdf: ships /usr/lib/python3/dist-packages/docs/Makefile etc.

[Andreas Beckmann]

Package: python3-asdf
Version: 2.13.0-1
Severity: serious
User: debian-qa at lists.debian.org
Usertags: piuparts

Hi,

during a test with piuparts I noticed ships documentation build systems
and generically named files under /usr/lib/python3/dist-packages/docs/,
causing file conflicts with other packages doing the same mistake.

Looking at the file list, I find the following badly placed files, not all
of them cause file conflicts:

/usr/lib/python3/dist-packages/compatibility_tests
/usr/lib/python3/dist-packages/compatibility_tests/assert_file_correct.py
/usr/lib/python3/dist-packages/compatibility_tests/common.py
/usr/lib/python3/dist-packages/compatibility_tests/generate_file.py
/usr/lib/python3/dist-packages/compatibility_tests/test_file_compatibility.py

If these modules really need to be shipped, they need to be in some
package specific directory (i.e. something containing asdf).

/usr/lib/python3/dist-packages/docs
/usr/lib/python3/dist-packages/docs/Makefile
/usr/lib/python3/dist-packages/docs/_static
/usr/lib/python3/dist-packages/docs/_static/logo.ico
/usr/lib/python3/dist-packages/docs/_static/logo.pdf
/usr/lib/python3/dist-packages/docs/_static/logo.png
/usr/lib/python3/dist-packages/docs/asdf
/usr/lib/python3/dist-packages/docs/asdf/CODE_OF_CONDUCT.md
/usr/lib/python3/dist-packages/docs/asdf/arrays.rst
/usr/lib/python3/dist-packages/docs/asdf/asdf_tool.rst
/usr/lib/python3/dist-packages/docs/asdf/changes.rst
/usr/lib/python3/dist-packages/docs/asdf/citation.rst
/usr/lib/python3/dist-packages/docs/asdf/config.rst
/usr/lib/python3/dist-packages/docs/asdf/contributing.rst
/usr/lib/python3/dist-packages/docs/asdf/developer_api.rst
/usr/lib/python3/dist-packages/docs/asdf/developer_overview.rst
/usr/lib/python3/dist-packages/docs/asdf/developer_versioning.rst
/usr/lib/python3/dist-packages/docs/asdf/extending
/usr/lib/python3/dist-packages/docs/asdf/extending/compressors.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/converters.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/extensions.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/legacy.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/manifests.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/resources.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/schemas.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/uris.rst
/usr/lib/python3/dist-packages/docs/asdf/extending/use_cases.rst
/usr/lib/python3/dist-packages/docs/asdf/features.rst
/usr/lib/python3/dist-packages/docs/asdf/install.rst
/usr/lib/python3/dist-packages/docs/asdf/overview.rst
/usr/lib/python3/dist-packages/docs/asdf/user_api.rst
/usr/lib/python3/dist-packages/docs/asdf/using_extensions.rst
/usr/lib/python3/dist-packages/docs/conf.py
/usr/lib/python3/dist-packages/docs/index.rst
/usr/lib/python3/dist-packages/docs/make.bat

Documentation belongs into /usr/share/doc/$PACKAGE, and the build system
is probaby not needed at all.


Andreas