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

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

[Slava Semushin]

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)

-- 
+ Slava Semushin | slava.semushin @ gmail.com
+ ALT Linux Team | php-coder @ altlinux.ru

Re: [devel] What is man.3pm?

[Mikhail Gusarov]

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

Twas brillig at 12:43:30 25.04.2008 UTC+07 when Slava Semushin did gyre and gimble:

 SS> Это что за ман такой? 3pm. Это для перла или как? Скорее всего, наш man не
 SS> готов к таким странным суфиксам.. (как минимум, ман может не
 SS> индексироваться и позже отсутствовать в резуальатах apropos/whatis)

Слава, а ты проверил, прежде чем чушь писать?

[mag@hasherhost:/usr/share/man]% cat /etc/altlinux-release 
ALT Linux Sisyphus (20071221)
[mag@hasherhost:/usr/share/man]% ls man3/*.3pm.gz | wc -l 
239

-- 
JID: dottedmag@altlinux.org / dottedmag@jabber.dottedmag.net

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

Re: [devel] What is man.3pm?

[Slava Semushin]

25 апреля 2008 г. 13:13 пользователь Mikhail Gusarov <dottedmag /
altlinux.org> написал:
> Twas brillig at 12:43:30 25.04.2008 UTC+07 when Slava Semushin did gyre and gimble:
>
>   SS> Это что за ман такой? 3pm. Это для перла или как? Скорее всего, наш man не
>   SS> готов к таким странным суфиксам.. (как минимум, ман может не
>   SS> индексироваться и позже отсутствовать в резуальатах apropos/whatis)
>
>  Слава, а ты проверил, прежде чем чушь писать?

Это не чушь, это мой вопрос.

(Я буду тебе благодарен если ты будешь более уважительно и в менее
вызывающих тонах писАть письма..)

>  [mag@hasherhost:/usr/share/man]% cat /etc/altlinux-release
>  ALT Linux Sisyphus (20071221)
>  [mag@hasherhost:/usr/share/man]% ls man3/*.3pm.gz | wc -l
>  239

[c0der@xxx ~]$ cat /etc/altlinux-release
ALT Linux Desktop (20070810)
[c0der@xxx ~]$ ls /usr/share/man/man3/*.3pm.*
zsh: no matches found: /usr/share/man/man3/*.3pm.*
[c1der@xxx ~]$


-- 
+ Slava Semushin | slava.semushin @ gmail.com
+ ALT Linux Team | php-coder @ altlinux.ru

Re: [devel] What is man.3pm?

[Mikhail Gusarov]

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

Twas brillig at 13:18:43 25.04.2008 UTC+07 when Slava Semushin did gyre and gimble:

 >>  Слава, а ты проверил, прежде чем чушь писать?
 SS> Это не чушь, это мой вопрос.

То есть не проверил.

 SS>> Скорее всего, наш man не готов к таким странным суфиксам.. (как минимум,
 SS>> ман может не индексироваться и позже отсутствовать в резуальатах
 SS>> apropos/whatis)

Это - чушь.

1) man к таким суффиксам готов к тысяча девятьсот затёртого года
2) эти суффиксы не странные
3) apropos/whatis эти суффиксы знает с тысяча девятьсот затёртого года.

 SS> (Я буду тебе благодарен если ты будешь более уважительно и в менее
 SS> вызывающих тонах писАть письма..)

Я буду очень благодарен, если ты перед тем, как писать чушь, заглянешь в
документацию на пару минут.

-- 
JID: dottedmag@altlinux.org / dottedmag@jabber.dottedmag.net

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

Re: [devel] What is man.3pm?

[Slava Semushin]

25 апреля 2008 г. 13:48 пользователь Mikhail Gusarov <dottedmag /
altlinux.org> написал:
>   >>  Слава, а ты проверил, прежде чем чушь писать?
>   SS> Это не чушь, это мой вопрос.
>
>  То есть не проверил.

Как я должен был его проверить? Я тебе выше привел вывод ls,
подтверждающий, что у меня на машине нет манов с таким суффиксом.

>   SS>> Скорее всего, наш man не готов к таким странным суфиксам.. (как минимум,
>   SS>> ман может не индексироваться и позже отсутствовать в резуальатах
>   SS>> apropos/whatis)
>
>  Это - чушь.
>
>  1) man к таким суффиксам готов к тысяча девятьсот затёртого года

Возможно. Я не проверял.

>  2) эти суффиксы не странные

?

Я их не разу не встречал.

>  3) apropos/whatis эти суффиксы знает с тысяча девятьсот затёртого года.

Сомневаюсь.

А уж а АЛЬТе так и вовсе запатченная версия используется, которая
может отставать от апстримной.

>   SS> (Я буду тебе благодарен если ты будешь более уважительно и в менее
>   SS> вызывающих тонах писАть письма..)
>
>  Я буду очень благодарен, если ты перед тем, как писать чушь, заглянешь в
>  документацию на пару минут.

В какую? Куда? Где это описано? man, что?


P.S. Миша, сбавь свой ментороский тон. Прошу ещё раз.


-- 
+ Slava Semushin | slava.semushin @ gmail.com
+ ALT Linux Team | php-coder @ altlinux.ru

Re: [devel] What is man.3pm?

[Mikhail Gusarov]

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

Twas brillig at 14:09:57 25.04.2008 UTC+07 when Slava Semushin did gyre and gimble:

 >>  То есть не проверил.

 SS> Как я должен был его проверить? Я тебе выше привел вывод ls,
 SS> подтверждающий, что у меня на машине нет манов с таким суффиксом.

Прочитать документацию.

 >>  2) эти суффиксы не странные
 SS> ?

!

 SS> Я их не разу не встречал.

Есть многое на свете, друг Горацио...

 >>  3) apropos/whatis эти суффиксы знает с тысяча девятьсот затёртого года.
 SS> Сомневаюсь.

Вот теперь ты пойдёшь и проверишь, с какого года он знают эти суффисы. А потом
придёшь сюда и публично извинишься.

 SS> А уж а АЛЬТе так и вовсе запатченная версия используется, которая может
 SS> отставать от апстримной.

О, да, на сорок лет ;)

 >>   SS> (Я буду тебе благодарен если ты будешь более уважительно и в менее
 >>   SS> вызывающих тонах писАть письма..)
 >>
 >>  Я буду очень благодарен, если ты перед тем, как писать чушь, заглянешь в
 >>  документацию на пару минут.

 SS> В какую? Куда? Где это описано? man, что?

man man
echo $MANSECT

 SS> P.S. Миша, сбавь свой ментороский тон. Прошу ещё раз.

Менторский тон от меня надо заслужить. Ты уже.

-- 
JID: dottedmag@altlinux.org / dottedmag@jabber.dottedmag.net

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

Re: [devel] What is man.3pm?

[Victor Forsyuk]

On Fri, Apr 25, 2008 at 02:28:24PM +0700, Mikhail Gusarov wrote:
> Twas brillig at 14:09:57 25.04.2008 UTC+07 when Slava Semushin did gyre and gimble:
> 
>  >>  То есть не проверил.
> 
>  SS> Как я должен был его проверить? Я тебе выше привел вывод ls,
>  SS> подтверждающий, что у меня на машине нет манов с таким суффиксом.
> 
> Прочитать документацию.
> 
>  >>  2) эти суффиксы не странные
>  SS> ?
> 
> !
> 
>  SS> Я их не разу не встречал.
> 
> Есть многое на свете, друг Горацио...
> 
>  >>  3) apropos/whatis эти суффиксы знает с тысяча девятьсот затёртого года.
>  SS> Сомневаюсь.
> 
> Вот теперь ты пойдёшь и проверишь, с какого года он знают эти суффисы. А потом
> придёшь сюда и публично извинишься.

А может всё-таки успокоимся?

Re: [devel] What is man.3pm?

[Andrey Rahmatullin]

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

On Fri, Apr 25, 2008 at 10:33:23AM +0300, Victor Forsyuk wrote:
> А может всё-таки успокоимся?
Угу, и перестанем писать в девел никому не нужные письма вида "я тут левой
пяткой подумал, а вдруг этот вот чужой код не заработает?". А то я так
могу на каждый чужой коммит писать.

-- 
WBR, wRAR (ALT Linux Team)
Powered by the ALT Linux fortune(8):

(сейчас меня кунут, но что делать)
		-- mike in devel@

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

Re: [devel] What is man.3pm?

[Victor Forsyuk]

On Fri, Apr 25, 2008 at 01:33:53PM +0600, Andrey Rahmatullin wrote:
> On Fri, Apr 25, 2008 at 10:33:23AM +0300, Victor Forsyuk wrote:
> > А может всё-таки успокоимся?
> Угу, и перестанем писать в девел никому не нужные письма вида "я тут левой
> пяткой подумал, а вдруг этот вот чужой код не заработает?". А то я так
> могу на каждый чужой коммит писать.

Это сформулировано как раскрытие моей мысли? Нет, я имел в виду совершенно
иное. Я предложил сделать нормой в team адекватное общение.

Re: [devel] What is man.3pm?

[Slava Semushin]

25 апреля 2008 г. 14:28 пользователь Mikhail Gusarov
<dottedmag@altlinux.org> написал:
[...]
>   >>  3) apropos/whatis эти суффиксы знает с тысяча девятьсот затёртого года.
>   SS> Сомневаюсь.
>
>  Вот теперь ты пойдёшь и проверишь, с какого года он знают эти суффисы. А потом
>  придёшь сюда и публично извинишься.

За что? За то что посмел усомниться в твох словах?

Я пол января копался в исходниках пакета man. whatis о секции p узнал
только с версии 1.5p (которая была явно не в 19XX, а где-то в 2005.
Про pm он (whatis, man-то их может и откроет) не в курсе (я уверен в
этом на чуть больше чем 50%)

[...]
>   >>   SS> (Я буду тебе благодарен если ты будешь более уважительно и в менее
>   >>   SS> вызывающих тонах писАть письма..)
>   >>
>   >>  Я буду очень благодарен, если ты перед тем, как писать чушь, заглянешь в
>   >>  документацию на пару минут.
>
>   SS> В какую? Куда? Где это описано? man, что?
>
>  man man

Выполнил.

>  echo $MANSECT

[c0der@xxx ~]$ echo $MANSECT

[c0der@xxx ~]$ grep -i mansect /etc/man.conf
# and the MANSECT environment variable is not set.
MANSECT         1:1p:8:2:3:3p:4:5:6:7:9:0p:tcl:n:l:p:o

Где тут 3pm?

>   SS> P.S. Миша, сбавь свой ментороский тон. Прошу ещё раз.
>
>  Менторский тон от меня надо заслужить. Ты уже.

Твоя предвзятость и напыщенность ни к чему хорошему не приведет...


-- 
+ Slava Semushin | slava.semushin @ gmail.com
+ ALT Linux Team | php-coder @ altlinux.ru

Re: [devel] What is man.3pm?

[Igor Zubkov]

25.04.08, Slava Semushin написал(а):
>  Я пол января копался в исходниках пакета man. whatis о секции p узнал
>  только с версии 1.5p (которая была явно не в 19XX, а где-то в 2005.
>  Про pm он (whatis, man-то их может и откроет) не в курсе (я уверен в
>  этом на чуть больше чем 50%)

Про whatis я не в курсе (надо посмотреть). Но про всё остальное ниже в письме.

>  >  echo $MANSECT
>
>  [c0der@xxx ~]$ echo $MANSECT
>
>  [c0der@xxx ~]$ grep -i mansect /etc/man.conf
>  # and the MANSECT environment variable is not set.
>  MANSECT         1:1p:8:2:3:3p:4:5:6:7:9:0p:tcl:n:l:p:o
>
>  Где тут 3pm?

Ты не понял про MANSECT. Это не расширения для файлов. Это расширение
для директорий.

$ rpm -qf /usr/share/man/man3/Test::Repocop::SQL.3pm.gz
repocop-0.07-alt0.8
$ rpm -ql repocop | grep man3
/usr/share/man/man3/Test::Repocop::Common.3pm.gz
/usr/share/man/man3/Test::Repocop::Metadata.3pm.gz
/usr/share/man/man3/Test::Repocop::Options.3pm.gz
/usr/share/man/man3/Test::Repocop::RPMdb.3pm.gz
/usr/share/man/man3/Test::Repocop::SQL.3pm.gz
$ man Test::Repocop::SQL
$

Ман мне его показал.

-- 
icesik

Re: [devel] What is man.3pm?

[Slava Semushin]

25 апреля 2008 г. 15:50 пользователь Igor Zubkov <igor.zubkov /
gmail.com> написал:
> 25.04.08, Slava Semushin написал(а):
>
> >  Я пол января копался в исходниках пакета man. whatis о секции p узнал
>  >  только с версии 1.5p (которая была явно не в 19XX, а где-то в 2005.
>  >  Про pm он (whatis, man-то их может и откроет) не в курсе (я уверен в
>  >  этом на чуть больше чем 50%)
>
>  Про whatis я не в курсе (надо посмотреть). Но про всё остальное ниже в письме.

Вроде находит. Я только что проверил.

[...]
>  Ты не понял про MANSECT. Это не расширения для файлов. Это расширение
>  для директорий.

Да. Действительно не понял...


Что ж. Тему можно закрыть. Спасибо за разъяснения.


-- 
+ Slava Semushin | slava.semushin @ gmail.com
+ ALT Linux Team | php-coder @ altlinux.ru

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

[Alexey Tourbin]

[-- 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 --]

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

[Led]

В сообщении от Friday 25 April 2008 19:01:20 Alexey Tourbin написал(а):
> 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 -- для окамля.
>
> От этой практики нужно отказаться.
> Достаточно различия по суффиксу.

Последние две фразы можно считать окончательным решением и руководством к 
действию? Т.е. переделать %_mandir/man3suffix/foo*.3* 
на  %_mandir/man3/foo*.3suffix ?

-- 
Led

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

[Alexey Tourbin]

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

On Fri, Apr 25, 2008 at 07:09:17PM +0300, Led wrote:
> > Есть и более радикальный подход -- создавать отдельные каталоги
> > в /usr/share/man с соответствующим суффиксом, напр
> > /usr/share/man/man3pm -- для перла;
> > /usr/share/man/man3f -- для фортрана;
> > /usr/share/man/man3o -- для окамля.
> >
> > От этой практики нужно отказаться.
> > Достаточно различия по суффиксу.
> 
> Последние две фразы можно считать окончательным решением и руководством к 
> действию? Т.е. переделать %_mandir/man3suffix/foo*.3* 
> на  %_mandir/man3/foo*.3suffix ?

Можно использовать %_man3dir.

См. /usr/share/doc/fhs-2.3
	/usr/share/man : Manual pages

В общем, это руководство к действию, но не догма. :)
Ещё одна проблема здесь в том, что FHS не предусматривает 'mann',
но 'mann' исторически используется и продолжает использоваться.

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