Comment utiliser les caractères Unicode dans Pod et perldoc?

Question

Je dois utiliser les caractères utf-8 dans ma documentation perl. Si j'utilise:

perldoc MyMod.pm

Je vois des personnages étranges. Si j'utilise:

pod2text MyMod.pm

tout va bien.

J'utilise 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-t-il un guide d'utilisation des caractères spéciaux dans Pod?

Voici un petit exemple utilisant des trémas allemands "Juste un test: & # 228; & # 246; & # 252; & # 223; & # 196; & # 214;":

$ 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

Utilisez = encoding utf-8 comme première directive POD de votre fichier et utilisez un perldoc relativement récent (par exemple, à partir de 5.10-maint). Alors ça devrait marcher.

Answer 2

Vous avez trouvé ce ticket RT ... http: // rt .cpan.org / Public / Bug / Display.html? id = 39000

Ce " bug " semble être introduit avec Perl 5.10 et peut-être que pod2man --utf8 doit être utilisé.

Answer 3

perldoc -t MyMod.pm

À partir du manuel perldoc:

-t Affiche le pod en utilisant pod2text au lieu de Pod :: Man et groff (-t est la valeur par défaut sur win32 sauf si -n est spécifié)