[devel] I: packaging texinfo documentation

[Dmitry V. Levin]

Greetings!

Вниманию packager'ов:

Если Вам приходится делать пакет, содержащий документацию в формате info,
то обратите внимание на следующие обстоятельства:

1. Установка документации производится с помощью макроса %install_info в
   секции %post.
   Удаление документации производится с помощью макроса %uninstall_info в
   в секции %preun.

   Пример:
   %post
   %install_info %name.info

   %preun
   %uninstall_info %name.info

2. Как правило, в этой документации, к сожалению, не указаны, либо указаны
   неправильно dircategory и direntry, необходимые для правильного
   обновления индекса документации (/etc/info-dir) утилитой install-info.

   Поэтому всю такую неправильную документацию надо сделать правильной
   путем пропатчивания. Реальный пример прилагается.

   В качестве секции, как правило, следует использовать имя группы пакета,
   в которой располагается документация, либо, если этот вариант не
   годится, какое-либо другое имя из файла
   /usr/share/doc/rpm-3.0.6/GROUPS, которое подходит больше.

   Некоторые Makefile'ы написаны таким образом, что .info-файлы не
   изготовляются заново, даже если исходные .texi-файлы являются более
   новыми. Имейте это в виду, иначе Ваши патчи не возымеют силы.


Regards,
	Dmitry

+-------------------------------------------------------------------------+
Dmitry V. Levin     mailto://ldv@fandra.org
Software Engineer   PGP pubkey http://www.fandra.org/users/ldv/pgpkeys.html
IPLabs Linux Team   http://linux.iplabs.ru
Fandra Project      http://www.fandra.org
+-------------------------------------------------------------------------+
UNIX is user friendly. It's just very selective about who it's friends are.
----------- следующая часть -----------
--- util-linux-2.10q-orig/sys-utils/ipc.texi	Fri Jul  9 06:56:41 1999
+++ util-linux-2.10q/sys-utils/ipc.texi	Tue Nov 14 22:32:48 2000
@@ -2,6 +2,10 @@
 @comment %**start of header (This is for running Texinfo on a region.)
 @setfilename ipc.info
 @settitle Inter Process Communication.
+ на dircategory Development/C
+ на direntry
+* IPC: (ipc).				System V style Inter Process Communication primitives.
+ на end direntry
 @setchapternewpage odd
 @comment %**end of header (This is for running Texinfo on a region.)
      
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 232 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/devel/attachments/20001114/42ded227/attachment-0001.bin>