Package: python-netaddr-docs
Version: 0.7.19-4
Severity: grave
Justification: renders package unusable
Dear Maintainer,
*** Reporter, please consider answering these questions, where appropriate ***
* What led up to the situation?
I wanted to read the documentation for the python-netaddr and
python3-netaddr packages.
* What exactly did you do (or not do) that was effective (or
ineffective)?
I opened the HTML files in /usr/share/doc/python-netaddr-docs,
expecting to read the documentation for the python-netaddr package.
* What was the outcome of this action?
The HTML files are there, but the following chapters/topics are empty
of text, and therefore unusable as documentation:
* Installing netaddr
* Tutorial 1: IP Addresses, Subnets and Ranges
* Tutorial 2: MAC addresses
* Tutorial 3: Working with IP sets
* Contributors
Only the "API Reference" topic/chapter has useful documentation, but a
dry reference is not always very helpful.
* What outcome did you expect instead?
I expected the above-mentioned files to contain equivalent
documentation as seen on these corresponding web pages:
https://netaddr.readthedocs.io/en/latest/installation.html
https://netaddr.readthedocs.io/en/latest/tutorial_01.html
https://netaddr.readthedocs.io/en/latest/tutorial_02.html
https://netaddr.readthedocs.io/en/latest/tutorial_03.html
https://netaddr.readthedocs.io/en/latest/contributors.html
*** End of the template - remove these template lines ***
-- System Information:
Debian Release: 10.8
APT prefers stable-updates
APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500,
'stable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386
Kernel: Linux 5.10.0-0.bpo.3-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8),
LANGUAGE=en_US:C:en:en_GB:sv_SE:sv_FI (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled
Versions of packages python-netaddr-docs depends on:
ii libjs-sphinxdoc 1.8.4-1
python-netaddr-docs recommends no packages.
python-netaddr-docs suggests no packages.
-- no debconf information
