PerlManPages

Perl man3 pages

Alexey Tourbin <at@> in [sisyphus perl man3 pages] Ср Дек 1 19:06:12 MSK 2004

Есть предложение перестать паковать man3 страницы в перловых пакетах.
Обоснование: они идентичны pod документации, содержащейся в исходниках.

Если это будет сделано, то предлагается использовать следующие варианты
просмотра документации:

1) perldoc
Минус -- привыкшим к man придется "переучиваться".

2) написать обертку для man, в простейшем случае такую:

man()
{
	command man "$@" || perldoc "$@"
}

Минус -- для перловой документации man completion в zsh не будет
работать (но это несложно исправить).

3) написать скрипт, который сканирует дерево перловых исходников и
автоматически генерирует/обновляет man страницы по заданному пути (по
умолчанию -- наверное в /usr/local/man).  Минус -- этот скрипт придется
запускать вручную (время от времени или по мере необходимости).