¿Cómo uso los caracteres Unicode en Pod y perldoc?
-
03-07-2019 - |
Pregunta
Necesito usar caracteres utf-8 en mi documentación de perl. Si uso:
perldoc MyMod.pm
Veo personajes extraños. Si uso:
pod2text MyMod.pm
todo está 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 un HowTo sobre el uso de caracteres especiales en Pod?
Aquí hay un pequeño ejemplo de las diéresis alemanas " 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)
Solución
Use = codificando 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.
Otros consejos
Encontré este ticket RT .... http: // rt .cpan.org / Public / Bug / Display.html? id = 39000
Este " error " Parece que se introdujo con Perl 5.10 y tal vez deba utilizarse este pod2man --utf8.
perldoc -t MyMod.pm
Desde el manual de perldoc:
-t Muestra pod usando texto pod2 en lugar de Pod :: Man y groff (-t es el valor predeterminado en win32 a menos que se especifique -n)