On Mon, Jul 20, 2020 at 04:36:05PM +0100, Neil Bothwick wrote: > i don't think that's the issue. The problem is that the man pages are not > included in the upstream package, only the source for them. So if you > want to be able to RTFM, you need a load of dependencies.
Perhaps a solution from upstream would be to distribute a simplified groff man page with the program, and then the package managers could enable the documentation requiring Sphinx only when the `doc` flag is set. It seems like pre-9.16 versions distributed a lot of basic man pages for all the various tools [1]. These have disappeared in recent versions. $ find bind-9.14.12/ -regextype sed -regex "^.*[a-zA-Z][^0-9]*\.[0-9]$" -type f bind-9.14.12/bin/dnssec/dnssec-dsfromkey.8 bind-9.14.12/bin/dnssec/dnssec-verify.8 bind-9.14.12/bin/dnssec/dnssec-importkey.8 bind-9.14.12/bin/dnssec/dnssec-keygen.8 bind-9.14.12/bin/dnssec/dnssec-revoke.8 bind-9.14.12/bin/dnssec/dnssec-cds.8 bind-9.14.12/bin/dnssec/dnssec-signzone.8 bind-9.14.12/bin/dnssec/dnssec-keyfromlabel.8 bind-9.14.12/bin/dnssec/dnssec-settime.8 bind-9.14.12/bin/delv/delv.1 bind-9.14.12/bin/tests/system/checkconf/dnssec.3 bind-9.14.12/bin/tests/system/checkconf/dnssec.2 bind-9.14.12/bin/tests/system/checkconf/dnssec.1 bind-9.14.12/bin/tests/system/statschannel/traffic.expect.5 bind-9.14.12/bin/tests/system/statschannel/traffic.expect.6 bind-9.14.12/bin/tests/system/statschannel/traffic.expect.2 bind-9.14.12/bin/tests/system/statschannel/traffic.expect.4 bind-9.14.12/bin/tests/system/statschannel/traffic.expect.1 bind-9.14.12/bin/tests/system/addzone/ns2/redirect.db.1 bind-9.14.12/bin/tests/system/addzone/ns2/redirect.db.2 bind-9.14.12/bin/tests/system/addzone/ns1/redirect.db.1 bind-9.14.12/bin/tests/system/addzone/ns1/redirect.db.2 bind-9.14.12/bin/tests/system/addzone/ns3/redirect.db.1 bind-9.14.12/bin/tests/system/addzone/ns3/redirect.db.2 bind-9.14.12/bin/confgen/ddns-confgen.8 bind-9.14.12/bin/confgen/rndc-confgen.8 bind-9.14.12/bin/named/named.conf.5 bind-9.14.12/bin/named/named.8 bind-9.14.12/bin/python/dnssec-checkds.8 bind-9.14.12/bin/python/dnssec-keymgr.8 bind-9.14.12/bin/python/dnssec-coverage.8 bind-9.14.12/bin/dig/host.1 bind-9.14.12/bin/dig/dig.1 bind-9.14.12/bin/dig/nslookup.1 bind-9.14.12/bin/check/named-checkzone.8 bind-9.14.12/bin/check/named-checkconf.8 bind-9.14.12/bin/tools/named-journalprint.8 bind-9.14.12/bin/tools/mdig.1 bind-9.14.12/bin/tools/dnstap-read.1 bind-9.14.12/bin/tools/named-rrchecker.1 bind-9.14.12/bin/tools/nsec3hash.8 bind-9.14.12/bin/tools/arpaname.1 bind-9.14.12/bin/tools/named-nzd2nzf.8 bind-9.14.12/bin/plugins/filter-aaaa.8 bind-9.14.12/bin/nsupdate/nsupdate.1 bind-9.14.12/bin/pkcs11/pkcs11-keygen.8 bind-9.14.12/bin/pkcs11/pkcs11-tokens.8 bind-9.14.12/bin/pkcs11/pkcs11-list.8 bind-9.14.12/bin/pkcs11/pkcs11-destroy.8 bind-9.14.12/bin/rndc/rndc.conf.5 bind-9.14.12/bin/rndc/rndc.8 bind-9.14.12/isc-config.sh.1 $ find bind-9.16.4/ -regextype sed -regex "^.*[a-zA-Z][^0-9]*\.[0-9]$" -type f bind-9.16.4/bin/tests/system/checkconf/dnssec.3 bind-9.16.4/bin/tests/system/checkconf/dnssec.2 bind-9.16.4/bin/tests/system/checkconf/dnssec.1 bind-9.16.4/bin/tests/system/statschannel/traffic.expect.5 bind-9.16.4/bin/tests/system/statschannel/traffic.expect.6 bind-9.16.4/bin/tests/system/statschannel/traffic.expect.2 bind-9.16.4/bin/tests/system/statschannel/traffic.expect.4 bind-9.16.4/bin/tests/system/statschannel/traffic.expect.1 bind-9.16.4/bin/tests/system/addzone/ns2/redirect.db.1 bind-9.16.4/bin/tests/system/addzone/ns2/redirect.db.2 bind-9.16.4/bin/tests/system/addzone/ns1/redirect.db.1 bind-9.16.4/bin/tests/system/addzone/ns1/redirect.db.2 bind-9.16.4/bin/tests/system/addzone/ns3/redirect.db.1 bind-9.16.4/bin/tests/system/addzone/ns3/redirect.db.2 [1] https://downloads.isc.org/isc/bind9/9.14.12/bind-9.14.12.tar.gz -- Ashley Dixon suugaku.co.uk 2A9A 4117 DA96 D18A 8A7B B0D2 A30E BF25 F290 A8AA
signature.asc
Description: PGP signature