¿Cómo uso los caracteres Unicode en Pod y perldoc?

documentation internationalization

Question

Necesito usar caracteres utf-8 en mi documentación perl. Si uso:

perldoc MyMod.pm

Veo personajes extraños. Si uso:

pod2text MyMod.pm

todo esta bien.

Yo uso 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

¿Hay algún HowTo sobre el uso de caracteres especiales en Pod?

Aquí hay un pequeño ejemplo con umlauts en alemán "Just a Test: äöüßÄÖ":

$ 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 la primera directiva POD en su archivo, y use un perldoc bastante reciente (por ejemplo de 5.10-maint). Entonces debería funcionar.

Answer 2

Encontrado este boleto RT .... http://rt.cpan.org/Public/Bug/Display.html?id=39000

Este "error" parece ser introducido con Perl 5.10 y quizás este pod2man --utf8 necesite ser utilizado.

Answer 3

perldoc -t MyMod.pm

Del manual perldoc:

-t Mostrar pod usando pod2text en lugar de Pod :: Man y groff (-t es el valor predeterminado en win32 a menos que se especifique -n)