PerlManPages

Материал из ALT Linux Wiki
Версия от 16:06, 28 июля 2008; SviatoslavSviridov (обсуждение | вклад) (Import from freesource.info)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Freesource-logo.png Blue Glass Arrow.svg MediaWiki logo.png
Эта страница была перемещена с 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).  Минус -- этот скрипт придется
запускать вручную (время от времени или по мере необходимости).