[devel] I: packaging texinfo documentation

[devel] I: packaging texinfo documentation

[Dmitry V. Levin]

[-- Attachment #1.1: Type: text/plain, Size: 1727 bytes --]

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.

[-- Attachment #1.2: util-linux-2.10q-texinfo.patch --]
[-- Type: text/plain, Size: 528 bytes --]

--- 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.)
      

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