Bug#699520: encoding issues in common::sense manpage

[Russ Allbery]

Jakub Wilk <jwilk at debian.org> writes:

> Package: libcommon-sense-perl
> Version: 3.6-1
> Severity: minor

> $ man common::sense | grep aXX
>           aXXNothing is more fairly distributed than common sense: no one thinks
>           he needs more of it than he already has.aXX
>           aXX RenA~X Descartes

> Adding "=encoding UTF-8" to the POD makes it slightly better, but curly
> quotes and the dash character as still rendered as "X".

Converting the documentation with pod2man -u (in addition to either adding
the =encoding line or using the latest and greatest Pod::Simple, which I
think defaults to UTF-8 now) will do the right thing on Debian.

I've not made that the default upstream pod2man behavior because I'm still
paranoid about distributed man pages with raw UTF-8, which are known to
cause severe heartburn for ancient Solaris nroff (for example).  But it's
probably time to bite the bullet and make UTF-8 output the default in the
next major release of podlators.

-- 
Russ Allbery (rra at debian.org)               <http://www.eyrie.org/~eagle/>