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

Иван Бессарабов ivan на bessarabov.ru
Чт Янв 21 02:25:19 PST 2010


=)

Отличный пример! Особенный шарм этой странице придает комментарий на русском =)

2010/1/21 Alexander Onokhov <ccnweb на gmail.com>:
> На русском???
>
> http://www.annocpan.org/~TAMASHIRO/Waft-0.9909/lib/Waft.pm
>
>
>
>
>
> 2010/1/21 Иван Бессарабов <ivan на bessarabov.ru>
>>
>> Привет.
>>
>> Прихожу к тому, что очень неплохо было бы писать документацию в самом
>> коде (а не в вики или в отдельных 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 mailing list
>> moscow-pm на pm.org | http://moscow.pm.org
>
>
>
> --
> Alexander
>
> --
> Moscow.pm mailing list
> moscow-pm на pm.org | http://moscow.pm.org
>
>


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