develooper Front page | perl.perl5.porters | Postings from November 2013

Re: [perl #114624] =encoding not honored by 'perldoc' command

Thread Previous | Thread Next
From:
Mark Allen
Date:
November 20, 2013 15:14
Subject:
Re: [perl #114624] =encoding not honored by 'perldoc' command
Message ID:
1384882681.24585.YahooMailNeo@web164005.mail.gq1.yahoo.com
Sorry if this is necro-posting - it's almost impossible to predict how any particular combination of
perldoc, {n|g|t}roff, fonts, locales, pagers, and/or terminal settings will handle UTF8 encoding. 

This is why I want to move away from groff/nroff/mandoc as the default renderer for perldoc.

The pain in doing that is the pod -> man -> groff display pathway has been the default for
a very long time and so has had most of its sharp edges sanded off.  Rendering pod using
terminal escape codes is pretty new and still is not perfect as the RT queue for perldoc shows
quite capably.

Mark



On Tuesday, September 17, 2013 6:14 PM, James E Keenan via RT <perlbug-followup@perl.org> wrote:
 
On Thu Sep 06 20:53:39 2012, mallen wrote:
> On Tue Aug 28 10:24:52 2012, explorer wrote:
> > Maybe the problem is with pod2man or a groff very old...
> 
> Hi. I'm the current maintainer for perldoc.  The problem is two fold.
> 
> 1) The perldoc in 5.14.x does not make any attempt to enable UTF-8
> characters in groff, even if
> groff supports it. This was fixed in 5.16.x
> 
> 2) Older groffs (those before 1.20.1) do not do *any* kind of UTF-8
> input processing at all.
> 
> Mark

I would infer from this explanation that with a sufficiently recent perl
and a sufficiently recent groff, the problem would not occur.

However, consider the situation on a Linux box where I have:

##########
$ perl -v

This is perl 5, version 18, subversion 1 (v5.18.1) built for i686-linux

$ groff -v
GNU groff version 1.21
##########

Here's the file I created, per instructions earlier in this thread:

#########
$ cat 114624-test.pm 
=pod

=encoding utf8

=head1 COPYRIGHT

Copyright © John Brown 2012.

#########

I see a copyright symbol there, as I do with 'pod2text':

#########
$ pod2text 114624-test.pm 
COPYRIGHT
    Copyright © John Brown 2012.

#########

But 'perldoc 114624-test.pm' just shows an 'X' where I want to see a
copyright symbol:


#########
114624-test(3)        User Contributed Perl Documentation      
114624-test(3)



COPYRIGHT
       Copyright X John Brown 2012.



perl v5.18.1                      2013-09-17                  
114624-test(3)
##########

So this limitation in 'perldoc' appears to persist.

Thank you very much.
Jim Keenan

---
via perlbug:  queue: perl5 status: open
https://rt.perl.org:443/rt3/Ticket/Display.html?id=114624
Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About