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

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

Thread Previous | Thread Next
From:
James E Keenan via RT
Date:
September 17, 2013 23:14
Subject:
[perl #114624] =encoding not honored by 'perldoc' command
Message ID:
rt-3.6.HEAD-1873-1379459650-1870.114624-15-0@perl.org
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