[Moscow.pm] Экспермиенты pod документация в utf8

Иван Бессарабов ivan на bessarabov.ru
Чт Янв 21 01:42:17 PST 2010


Привет.

Прихожу к тому, что очень неплохо было бы писать документацию в самом
коде (а не в вики или в отдельных README).
Документация пишется на русском языке, все знают английский, но
согласитесь удобнее писать и читать на родном языке.

Вот элементарный файл с которым я играюсь:
{{{
#! /usr/bin/perl

use strict;
use warnings;

=encoding UTF-8
=cut

=head1 TEST

АБВ

=cut
}}}

pod2text прекрасно все пишет на русском (ему главное чтобы =encoding UTF-8 был)

Долго экспериментировал, чтобы заставить perldoc работать.
Нашел замечательный тред http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=492037

В конце концов пришел к следующему жуткому решению:
{{{
pod2man --utf8 a.pl | iconv -t iso8859-5 | nroff -Tlatin1 -c -man - |
iconv -f iso8859-5 | less
}}}

У кого-нибудь perldoc работает нормально с документацией в utf8 и как
вы этого добились?


Подробная информация о списке рассылки Moscow-pm