Como faço para usar caracteres Unicode em Pod e perldoc?

Question

Eu preciso usar caracteres UTF-8 no meu perl-documentação. Se eu usar:

perldoc MyMod.pm

Eu vejo caracteres estranhos. Se eu usar:

pod2text MyMod.pm

está tudo bem.

Eu uso o Ubuntu / Debian.

$ locale
LANG=de_DE.UTF-8
LC_CTYPE="de_DE.UTF-8"
LC_NUMERIC="de_DE.UTF-8"
LC_TIME="de_DE.UTF-8"
LC_COLLATE="de_DE.UTF-8"
LC_MONETARY="de_DE.UTF-8"
LC_MESSAGES="de_DE.UTF-8"
LC_PAPER="de_DE.UTF-8"
LC_NAME="de_DE.UTF-8"
LC_ADDRESS="de_DE.UTF-8"
LC_TELEPHONE="de_DE.UTF-8"
LC_MEASUREMENT="de_DE.UTF-8"
LC_IDENTIFICATION="de_DE.UTF-8"
LC_ALL=de_DE.UTF-8

Existe um HowTo sobre o uso de caracteres especiais em Pod?

Aqui está um pequeno exemplo usando tremas alemão "apenas um teste: äöüßÄÖ":

$ perldoc perl/MyMod.pm
<standard input>:72: warning: can't find character with input code 159
<standard input>:72: warning: can't find character with input code 150
MyMod(3)              User Contributed Perl Documentation             MyMod(3)

NAME
        MyMod.pm - Just a Test: äöüÃÃÃ

perl v5.10.0                      2008-10-16                          MyMod(3)

Answer 1

Use =encoding utf-8 como a primeira directiva POD em seu arquivo, e usar um perldoc bastante recente (por exemplo, de 5,10-maint). Em seguida, ele deve funcionar.

Answer 2

Encontrado este bilhete RT .... http: // t.a. .cpan.org / Public / Bug / Display.html? id = 39000

Esta "bug" parece ser introduzido com Perl 5.10 e talvez isso pod2man --utf8 necessidades a ser utilizado.

Answer 3

perldoc -t MyMod.pm

A partir do perldoc manual:

-t exibição pod usando pod2text vez de Pod :: Homem e groff (-t é o padrão em win32 menos -n é especificado)