devel@ where you _can_ ask
 help / color / mirror / Atom feed
* [newbies] Создание manpages
@ 2010-11-22 19:18 Kharitonov A. Dmitry
  2010-11-22 19:23 ` Slava Semushin
  0 siblings, 1 reply; 9+ messages in thread
From: Kharitonov A. Dmitry @ 2010-11-22 19:18 UTC (permalink / raw)
  To: devel-newbies

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



^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 19:18 [newbies] Создание manpages Kharitonov A. Dmitry
@ 2010-11-22 19:23 ` Slava Semushin
  2010-11-22 19:54   ` Kharitonov A. Dmitry
  0 siblings, 1 reply; 9+ messages in thread
From: Slava Semushin @ 2010-11-22 19:23 UTC (permalink / raw)
  To: devel@ where you _can_ ask

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

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 19:23 ` Slava Semushin
@ 2010-11-22 19:54   ` Kharitonov A. Dmitry
  2010-11-22 19:57     ` Slava Semushin
  0 siblings, 1 reply; 9+ messages in thread
From: Kharitonov A. Dmitry @ 2010-11-22 19:54 UTC (permalink / raw)
  To: devel@ where you _can_ ask

  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 для русскоязычных.
Т.е. отдельный пакет для национальных заводить не надо?

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



^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 19:54   ` Kharitonov A. Dmitry
@ 2010-11-22 19:57     ` Slava Semushin
  2010-11-22 20:00       ` Slava Semushin
  2010-11-22 20:09       ` Kharitonov A. Dmitry
  0 siblings, 2 replies; 9+ messages in thread
From: Slava Semushin @ 2010-11-22 19:57 UTC (permalink / raw)
  To: devel@ where you _can_ ask

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

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

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

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


-- 
Slava Semushin

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 19:57     ` Slava Semushin
@ 2010-11-22 20:00       ` Slava Semushin
  2010-11-22 20:09       ` Kharitonov A. Dmitry
  1 sibling, 0 replies; 9+ messages in thread
From: Slava Semushin @ 2010-11-22 20:00 UTC (permalink / raw)
  To: devel@ where you _can_ ask

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

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 19:57     ` Slava Semushin
  2010-11-22 20:00       ` Slava Semushin
@ 2010-11-22 20:09       ` Kharitonov A. Dmitry
  2010-11-22 20:11         ` Slava Semushin
  1 sibling, 1 reply; 9+ messages in thread
From: Kharitonov A. Dmitry @ 2010-11-22 20:09 UTC (permalink / raw)
  To: devel@ where you _can_ ask

  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



^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 20:09       ` Kharitonov A. Dmitry
@ 2010-11-22 20:11         ` Slava Semushin
  2010-11-22 20:24           ` Kharitonov A. Dmitry
  0 siblings, 1 reply; 9+ messages in thread
From: Slava Semushin @ 2010-11-22 20:11 UTC (permalink / raw)
  To: devel@ where you _can_ ask

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

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

-- 
Slava Semushin

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 20:11         ` Slava Semushin
@ 2010-11-22 20:24           ` Kharitonov A. Dmitry
  2010-11-22 20:29             ` Slava Semushin
  0 siblings, 1 reply; 9+ messages in thread
From: Kharitonov A. Dmitry @ 2010-11-22 20:24 UTC (permalink / raw)
  To: devel@ where you _can_ ask

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




^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [newbies] Создание manpages
  2010-11-22 20:24           ` Kharitonov A. Dmitry
@ 2010-11-22 20:29             ` Slava Semushin
  0 siblings, 0 replies; 9+ messages in thread
From: Slava Semushin @ 2010-11-22 20:29 UTC (permalink / raw)
  To: devel@ where you _can_ ask

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

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

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

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

-- 
Slava Semushin

^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2010-11-22 20:29 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-11-22 19:18 [newbies] Создание manpages Kharitonov A. Dmitry
2010-11-22 19:23 ` Slava Semushin
2010-11-22 19:54   ` Kharitonov A. Dmitry
2010-11-22 19:57     ` Slava Semushin
2010-11-22 20:00       ` Slava Semushin
2010-11-22 20:09       ` Kharitonov A. Dmitry
2010-11-22 20:11         ` Slava Semushin
2010-11-22 20:24           ` Kharitonov A. Dmitry
2010-11-22 20:29             ` Slava Semushin

devel@ where you _can_ ask

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://lore.altlinux.org/devel-newbies/0 devel-newbies/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 devel-newbies devel-newbies/ http://lore.altlinux.org/devel-newbies \
		devel-newbies@lists.altlinux.org devel-newbies@lists.altlinux.ru devel-newbies@lists.altlinux.com
	public-inbox-index devel-newbies

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://lore.altlinux.org/org.altlinux.lists.devel-newbies


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git