Вход:  Пароль:  
FreeSource: AltLinux/Policy/PerlMan ...
Free Source | Каталог | Изменения | НовыеКомментарии | Пользователи | Регистрация |
Эта страница была перенесена на altlinux.org. Текст на freesource.info заморожен.

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


Страницы, ссылающиеся на данную: AltLinux/Policy
Altlinux/Policy


 
Файлов нет. [Показать файлы/форму]
Комментариев нет. [Показать комментарии/форму]