[newbies] Создание manpages

[newbies] Создание manpages

[Kharitonov A. Dmitry]

  Как правильно создавать мануалы?
Как создавать многонациональные мануалы?
Как правильно упаковывать те и другие?

Re: [newbies] Создание manpages

[Slava Semushin]

23 ноября 2010 г. 1:18 пользователь Kharitonov A. Dmitry
<kharpost@rambler.ru> написал:
>  Как правильно создавать мануалы?

man 7 man
man man-pages
http://www.linuxfocus.org/Russian/November2003/article309.shtml

> Как создавать многонациональные мануалы?

Они ничем внутри не отличаются от англоязычных -- только языком.

> Как правильно упаковывать те и другие?

Просто положить их в правильные места (где их найдет man/makewhtis) --
/usr/share/man для англоязычных и /usr/share/man/ru для русскоязычных.


-- 
Slava Semushin

Re: [newbies] Создание manpages

[Kharitonov A. Dmitry]

  22.11.2010 22:23, Slava Semushin пишет:
> 23 ноября 2010 г. 1:18 пользователь Kharitonov A. Dmitry
> <kharpost@rambler.ru>  написал:
>
>> Как правильно упаковывать те и другие?
> Просто положить их в правильные места (где их найдет man/makewhtis) --
> /usr/share/man для англоязычных и /usr/share/man/ru для русскоязычных.
Т.е. отдельный пакет для национальных заводить не надо?

Как дело обстоит с переводами? куда они пакуются?

Re: [newbies] Создание manpages

[Slava Semushin]

23 ноября 2010 г. 1:54 пользователь Kharitonov A. Dmitry
<kharpost@rambler.ru> написал:
[...]
>> Просто положить их в правильные места (где их найдет man/makewhtis) --
>> /usr/share/man для англоязычных и /usr/share/man/ru для русскоязычных.
>
> Т.е. отдельный пакет для национальных заводить не надо?

Как правило нет. (Т.к. на программу не больше десятка манов, а это не много.)

> Как дело обстоит с переводами? куда они пакуются?

Переводы чего?


-- 
Slava Semushin

Re: [newbies] Создание manpages

[Slava Semushin]

23 ноября 2010 г. 1:57 пользователь Slava Semushin
<slava.semushin@gmail.com> написал:
> 23 ноября 2010 г. 1:54 пользователь Kharitonov A. Dmitry
> <kharpost@rambler.ru> написал:
> [...]
>>> Просто положить их в правильные места (где их найдет man/makewhtis) --
>>> /usr/share/man для англоязычных и /usr/share/man/ru для русскоязычных.
>>
>> Т.е. отдельный пакет для национальных заводить не надо?
>
> Как правило нет. (Т.к. на программу не больше десятка манов, а это не много.)

Плюс, если мэйнтейнер упаковал маны с использованием скрипта
%find_lang (либо вручную указав %lang в спеке), то rpm будет
устанавливать только те маны, язык для которых указан в
%_install_langs.

Пример:
[c0der@rock ~]$ rpm --eval %_install_langs
ru_RU

Т.е. при установке пакета с манами на разных языках ко мне будут
установлены только англоязычные и русскоязычные. (Это легко проверять
посмотрев на вывод rpm -qs для конкретного пакета.)


-- 
Slava Semushin

Re: [newbies] Создание manpages

[Kharitonov A. Dmitry]

  22.11.2010 22:57, Slava Semushin пишет:
> 23 ноября 2010 г. 1:54 пользователь Kharitonov A. Dmitry
> <kharpost@rambler.ru>  написал:
> [...]
>>> Просто положить их в правильные места (где их найдет man/makewhtis) --
>>> /usr/share/man для англоязычных и /usr/share/man/ru для русскоязычных.
>> Т.е. отдельный пакет для национальных заводить не надо?
> Как правило нет. (Т.к. на программу не больше десятка манов, а это не много.)
>
>> Как дело обстоит с переводами? куда они пакуются?
> Переводы чего?
чужих манов, например, sed

Re: [newbies] Создание manpages

[Slava Semushin]

23 ноября 2010 г. 2:09 пользователь Kharitonov A. Dmitry
<kharpost@rambler.ru> написал:
[...]
>>> Как дело обстоит с переводами? куда они пакуются?
>>
>> Переводы чего?
>
> чужих манов, например, sed

Обычно такие маны помещаются в специализированный пакет man-pages-ru.

-- 
Slava Semushin

Re: [newbies] Создание manpages

[Kharitonov A. Dmitry]

  22.11.2010 23:11, Slava Semushin пишет:
> 23 ноября 2010 г. 2:09 пользователь Kharitonov A. Dmitry
> <kharpost@rambler.ru>  написал:
> [...]
>>>> Как дело обстоит с переводами? куда они пакуются?
>>> Переводы чего?
>> чужих манов, например, sed
> Обычно такие маны помещаются в специализированный пакет man-pages-ru.
А переводы манов прикладных программ туда же?
А переводы doc-ов куда?

Re: [newbies] Создание manpages

[Slava Semushin]

23 ноября 2010 г. 2:24 пользователь Kharitonov A. Dmitry
<kharpost@rambler.ru> написал:
[...]
>>>>> Как дело обстоит с переводами? куда они пакуются?
>>>>
>>>> Переводы чего?
>>>
>>> чужих манов, например, sed
>>
>> Обычно такие маны помещаются в специализированный пакет man-pages-ru.
>
> А переводы манов прикладных программ туда же?

Нет устоявшейся практики -- программа может таскать с собой перевод
для мана (как правило такое бывает, когда этот перевод из апстрима и
пришел вместе с программой), а может и отдать на откуп пакету
man-pages-ru (такое бывает, когда ман перевёл кто-то другой, в
апстриме его нет и мэйнтейнер этого пакета не пожелал включить перевод
в сам пакет.)

> А переводы doc-ов куда?

Как правило, они вместе с программой.

-- 
Slava Semushin