Skip Menu |

This queue is for tickets about the Pod-Perldoc CPAN distribution.

Report information
The Basics
Id: 111261
Status: open
Priority: 0/
Queue: Pod-Perldoc

People
Owner: Nobody in particular
Requestors: MPERRY [...] cpan.org
Cc: SREZIC [...] cpan.org
AdminCc:

Bug Information
Severity: (no value)
Broken in: 3.25
Fixed in: (no value)



Subject: E<ouml> not rendering properly
When I run "perldoc File::Spec" the resulting documentation shows Andreas König's name as "Andreas K<F6>nig". I've verified this result using Perldoc v3.25 with Perl 5.22.0 on CentOS 6.7 and Cygwin. LANG is set to en_US.UTF-8 and TERM is xterm. When I switch back to the system perl on CentOS the text is correctly rendered as "Andreas Koenig". That's using Perldoc v3.14_04 with Perl 5.10.1. I was able to get the correct behavior with Perldoc v3.25 if I added "=encoding utf8" to the POD in File::Spec. However, I don't know if that's the right place to fix it or if it should be fixed in Pod::Text or in Perldoc.
On 2016-01-16 18:04:17, MPERRY wrote: Show quoted text
> When I run "perldoc File::Spec" the resulting documentation shows > Andreas König's name as "Andreas K<F6>nig". > > I've verified this result using Perldoc v3.25 with Perl 5.22.0 on > CentOS 6.7 and Cygwin. LANG is set to en_US.UTF-8 and TERM is xterm. > > When I switch back to the system perl on CentOS the text is correctly > rendered as "Andreas Koenig". That's using Perldoc v3.14_04 with Perl > 5.10.1. > > I was able to get the correct behavior with Perldoc v3.25 if I added > "=encoding utf8" to the POD in File::Spec. However, I don't know if > that's the right place to fix it or if it should be fixed in Pod::Text > or in Perldoc.
Also broken, with the same effect (output of "<F6>") ("ö" is here encoded as latin1): =encoding iso-8859-1 Andreas König =cut
On Sat Jan 16 18:04:17 2016, MPERRY wrote: Show quoted text
> When I run "perldoc File::Spec" the resulting documentation shows > Andreas König's name as "Andreas K<F6>nig". > > I've verified this result using Perldoc v3.25 with Perl 5.22.0 on > CentOS 6.7 and Cygwin. LANG is set to en_US.UTF-8 and TERM is xterm. > > When I switch back to the system perl on CentOS the text is correctly > rendered as "Andreas Koenig". That's using Perldoc v3.14_04 with Perl > 5.10.1. > > I was able to get the correct behavior with Perldoc v3.25 if I added > "=encoding utf8" to the POD in File::Spec. However, I don't know if > that's the right place to fix it or if it should be fixed in Pod::Text > or in Perldoc.
I've gone back and forth on this, but my general opinion is that if the underlying POD contains utf8, it needs to explicitly tell perldoc to use UTF8 (or latin-1) or whatever. The only time perldoc "guesses" that it should use UTF8 is when it pulls an extract out of the perlop or perlfaq documents using the "-f" switch.