Perl проблемы с perldoc

by wa   4.10.2015    7670 просмотров

Возникла некоторая беда с perldoc на одной машине, консоль выводила что-то невнятное:

$ perldoc lib/libName/Module.pm  
/usr/bin/groff: can't find DESC' file  
/usr/bin/groff:fatal error: invalid device ps'

Что-то пошло не так, попробовал обновить groff через консоль: $ sudo apt-get upgrade groff-base

Но, как оказалось не надо, ладно, пойдём другим путём, залез на сайт пакетов Ubuntu, нашёл нужный:
http://packages.ubuntu.com/trusty/groff-base

Ну хорошо, проверяем, ошибок groff нету, но вместо букв русских символы XX.

libName::Module(3) User Contributed Perl Documentation libName::Module(3)  
NAME  
Module - module based application  
SYNOPSIS  
XXXXXXXXX XXXXXX  
DESCRIPTION  
XXXXXXXX XXXXXXXX XXXXX XXXXXXX XXXXXX  
# и так далее

Великий help: $ perldoc --help, есть какой-то ключ -t с описанием:

"Display pod using pod2text instead of Pod::Man and groff (-t is the default on win32 unless -n is specified)

Буквы отобразились, но pod разметки нет, всё в куче.

Капитан подкинул самое очевидное: надо обновить модуль который работает с perldoc -> Pod::Perldoc

$ cpanm Pod::Perldoc  
--> Working on Pod::Perldoc  
Fetching http://www.cpan.org/authors/id/M/MA/MALLEN/Pod-Perldoc-3.25.tar.gz ... OK  
Configuring Pod-Perldoc-3.25 ... OK  
Building and testing Pod-Perldoc-3.25 ... OK  
Successfully installed Pod-Perldoc-3.25 (upgraded from 3.19)  
1 distribution installed

Ииииии:

NAME  
   Module - module based application  
SYNOPSIS  
   используй модуль  
DESCRIPTION  
   Шикарное описание этого важного модуля  
SEE ALSO  
   Module  
AUTHOR  
   developer и компания

Таки всё. Профит.