Perl manpages

Ниже собраны письма, описывающие предлагаемый at@ (насколько понимаю) механизм работы с man-страницами в perl-пакетах, собранных и установленных в ALT Linux. По мере уточнения и понимания из них можно сделать документ с рекомендациями.

On Tue, Aug 16, 2005 at 12:12:42PM +0400, Konstantin A. Lepikhov wrote: > т.е. можно приступать к убиванию секции man в perl- пакетах? Да. В своих пакетах я давно перестал паковать man3 страницы (т.е. для модулей, вида Some::Module). По части man1 страниц -- предлагаю не паковать man1 страницы для специфических перловых программ (например, pod2man или dprofpp), но паковать их для "обычных" программ, написанных на перле (например, grepmail).
http://lists.altlinux.ru/pipermail/sisyphus/2005-August/067464.html

On Wed, Aug 17, 2005 at 08:25:45AM +0400, Alexey V. Novikov wrote: > >This packages has two scripts: > >1) /usr/sbin/perlman, capable of generating manual pages for all > >perl modules and pod files under "core" and "vendor" directores; > >2) /etc/cron.daily/perlman, a daily job that will generate/update > >manual pages in /var/cache/perlman/man{1,3} and then will make > >symbolic links for them in /usr/local/man/man{1,3}. > А может не надо их в ^^^^^^^^^^? Я над этим много думал. man-страницы -- генерат. Там выполняется большое количество перлового кода. От рута пускать его нельзя. Следовательно, напрямую ни в /usr, ни в /usr/local генерить ничего нельзя. Поэтому создаётся каталог /var/cache/perlman с правами 2775 root:man, а скрипт /usr/sbin/perlman пускается от псевдоюзера cacheman. Далее, /usr/share должен быть полностью под контролем rpm. Никакой отсебятены туда лучше не ставить. Поэтому линки на генерат я решил ставить в /usr/local/man. К счастью, поиск в этом каталоге работает "из коробки". $ grep /usr/local/man /etc/man.conf MANPATH /usr/local/man MANPATH_MAP /usr/local/bin /usr/local/man MANPATH_MAP /usr/local/sbin /usr/local/man $
http://lists.altlinux.ru/pipermail/sisyphus/2005-August/067483.html

On Wed, Aug 17, 2005 at 10:05:06AM +0400, Alexey Tourbin wrote: > On Wed, Aug 17, 2005 at 09:42:12AM +0400, Alexey V. Novikov wrote: > > >$ grep /usr/local/man /etc/man.conf > > >MANPATH /usr/local/man > > >MANPATH_MAP /usr/local/bin /usr/local/man > > >MANPATH_MAP /usr/local/sbin /usr/local/man > > >$ > > А если у меня /usr в read-only? Я что совсем без манов останусь? > > А. Я подумал, что предлагается ставить линки в /usr/share. :) > Ну не знаю. /usr/local иногда отдельным разделом бывает. > Скрипт /etc/cron.daily/perlman помечен как %config. Кстати, эти два скрипта имеют замечательную особенность: они работают в инкрементном режиме. При первом запуске скрипты отрабатывают несколько минут (на создании генерата), при последующих запусках -- несколько секунд. То есть *если* в /usr/lib/perl5 ничего не изменилось, *то* ни в /var/cache/perlman, ни в /usr/local/man также ничего меняться не будет. В этом состоит решение вашей проблемы: если вы только что поставили или обновили перловые пакеты, то /usr у вас, очевидно, ещё смонтирован в rw. Тогда можно вручную запустить /etc/cron.daily/perlman, он сделает генерат и поставит симлинки в /usr/local/man. После этого /usr можно перемонтировать в ro.
http://lists.altlinux.ru/pipermail/sisyphus/2005-August/067491.html