Эта страница была перенесена на
altlinux.org. Текст на freesource.info заморожен.
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). Минус — этот скрипт придется
запускать вручную (время от времени или по мере необходимости).