Bug#917530: perldoc formatting unfortunately degraded by upstream compatability fix

[Anthony DeRobertis]

Package: perl-doc
Version: 5.28.1-3
Severity: normal

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

In f2ee4cb897ec9dd3338abcd0e9a42cb41ce9a173[0] upstream worked around
reported issues with perldoc by changing the default formatter to ToText
(from ToTerm) and also getting rid of automatically setting pager
options (like -R to less). 

This, of course, also removed all bold/underline/etc. from the output,
making perldoc less readable.

- From reading through the various related bugs (e.g., [1]) it seems like
they switched away from using groff (via ToMan) because Mac OS Sierra
has a groff without Unicode support. That obviously doesn't apply to
Debian, so it seems we could have nice rendering without any pager
workarounds just by changing the default back to Pod::Perldoc::ToMan.

Or at least a note in README.Debian about adding something like one of
these to .bashrc:

    export PERLDOC=-oTerm PERLDOC_PAGER='less -R' # works like Stretch, Jessie
    export PERLDOC=-oMan                          # works like Wheezy

[0]: https://perl5.git.perl.org/perl.git/commit/f2ee4cb897ec9dd3338abcd0e9a42cb41ce9a173
[1]: https://rt.cpan.org/Public/Bug/Display.html?id=120229

- -- System Information:
Debian Release: buster/sid
  APT prefers testing-debug
  APT policy: (500, 'testing-debug'), (500, 'testing'), (500, 'stable'), (130, 'unstable-debug'), (130, 'unstable'), (120, 'experimental-debug'), (120, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.18.0-2-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages perl-doc depends on:
ii  perl  5.28.1-3

perl-doc recommends no packages.

Versions of packages perl-doc suggests:
ii  groff-base               1.22.3-10
ii  konqueror [man-browser]  4:18.04.0-1+b2
ii  man-db [man-browser]     2.8.4-3

- -- no debconf information

-----BEGIN PGP SIGNATURE-----

iHMEARECADMWIQTlAc7j4DAtSNRJJ0z7P4jCVepZ/gUCXCXtuhUcYW50aG9ueUBk
ZXJvYmVydC5uZXQACgkQ+z+IwlXqWf4WmgCfeiTVl76yHBuWJTrEy3XJfMhQorkA
n02XnQ95YomQyzy/WHvImWA5MD9w
=dQql
-----END PGP SIGNATURE-----