Re: [devel] What is man.3pm? [was: Re: [git update] packages/owfs: heads/master]

[Alexey Tourbin <at@altlinux.ru>]

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

On Fri, Apr 25, 2008 at 12:43:30PM +0700, Slava Semushin wrote:
> 2008/4/25 Denis Klimov <zver%altlinux.org>:
> > Update of /people/zver/packages/owfs.git
> [...]
> >  commit 6979a8e0985862269b44e1b81c4527ba233fb951
> >  Author: Vladimir V. Kamarzin <vvk%altlinux.org>
> >  Date:   Thu Apr 24 12:51:18 2008 +0600
> >
> >     owfs.spec: package OWNet.3pm.gz manpage
> >     Signed-off-by: Vladimir V. Kamarzin <vvk%altlinux.org>
> [...]
> 
> Это что за ман такой? 3pm. Это для перла или как? Скорее всего, наш
> man не готов к таким странным суфиксам.. (как минимум, ман может не
> индексироваться и позже отсутствовать в резуальатах apropos/whatis)

Иногда хочется дискриминировать маны по их характерной окраске.
Для этого исторически используется суффикс в манах, особенно для
генерата (для названия модулей в языках программировния и т.п.).
Например, lib.3pm относится к перловому модулю lib (см. perldoc lib).
Другой ман lib.* может относиться к чему-то ещё.

Короче, суффикс манов используется в том числе и для разруливания
файловых конфликтов.  См. напр. жалобу #5141 - "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".

Были более характерные жалобы, но сейчас их с ходу трудно найти.

Есть и более радикальный подход -- создавать отдельные каталоги
в /usr/share/man с соответствующим суффиксом, напр
/usr/share/man/man3pm -- для перла;
/usr/share/man/man3f -- для фортрана;
/usr/share/man/man3o -- для окамля.

От этой практики нужно отказаться.
Достаточно различия по суффиксу.

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