Как использовать символы Unicode в Pod и perldoc?

Мне нужно использовать символы utf-8 в моей perl-документации. Если я использую:

perldoc MyMod.pm

Я вижу странные символы. Если я использую:

pod2text MyMod.pm

все хорошо.

Я использую 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

Есть ли руководство по использованию специальных символов в Pod?

Вот небольшой пример использования умлаутов на немецком языке «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)

internationalization unicode documentation perl perldoc
person maletin    schedule 16.10.2008    source источник
comment
Что за странные персонажи? Вопросительные знаки? Коробки? Странные коды форматирования ANSI?   -  person 1800 INFORMATION    schedule 16.10.2008

Ответы (3)


arrow_upward
19
arrow_downward

Используйте =encoding utf-8 в качестве первой директивы POD в вашем файле и используйте довольно новую директиву perldoc (например, из 5.10-maint). Тогда это должно работать.

person moritz    schedule 16.10.2008
comment
этот ответ кажется правильным. Спасибо. я нашел более подробную информацию в perldoc perlpod. - person maletin; 17.10.2008
comment
В документе указано =encoding utf8, а не =encoding utf-8. Но с 5.18 в Ubuntu это кажется ненужным, а в 5.16 на Mac OS X 10.10.4, похоже, ничего не работает. - person TextGeek; 27.08.2015

arrow_upward
6
arrow_downward

Нашел этот билет RT.... http://rt.cpan.org/Public/Bug/Display.html?id=39000

Эта «ошибка», похоже, появилась в Perl 5.10, и, возможно, нужно использовать этот pod2man --utf8.

person draegtun    schedule 16.10.2008

arrow_upward
0
arrow_downward

perldoc -t MyMod.pm

Из руководства perldoc:

-t Отображать pod, используя pod2text вместо Pod::Man и groff (-t используется по умолчанию в win32, если не указано -n)

person user8024242    schedule 17.05.2017