[sisyphus] perl man3 pages

[Alexey Tourbin <at@altlinux.ru>]

[-- Attachment #1: Type: text/plain, Size: 1174 bytes --]

On Wed, Dec 01, 2004 at 10:25:48PM +0800, Sergei Dolmatov wrote:
> file /usr/share/man/man3/lib.3.gz from install of erlang-R9C.0-alt3 conflicts with file from package perl-man3-5.8.4-alt1
> file /usr/share/man/man3/crypto.3.gz from install of erlang-R9C.0-alt3 conflicts with file from package libssl-devel-0.9.7d-alt1
> E: Ошибка во время исполнения транзакции

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

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

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

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

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

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

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

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]