Re: Transition from dpkg to GNU install-info

[Norbert Preining <preining@logic.at>]

On Mo, 27 Apr 2009, Raphael Hertzog wrote:
> In theory yes, but since those are real bugs in the documentation I think
> nobody will complain if you omit that step (and you're the Debian expert
> for info files since you maintain texinfo).

Ok, here is a bug email, if someone wants to read it before I send it
out:
----------------------------------

Dear maintainer,

we are currently replacing the dpkg install-info with GNU install-info
and at the same time reworking the installation method for info files
with triggers.

As a package maintainer your only job is to drop info files below
/usr/share/info and the package install-info will care for the rest
by recreating the dir file from all installed info files.

There is one problem in the info files of your packages
	#PACKAGE#
because the files:
	#FILES#
do not ship info dir sections. So calling install-info (the GNU version)
on these files issue a warning:
	install-info: warning: no info dir entry in `/usr/share/info/...'
and the file is not included in the dir file.

The source of this problem is the following missing entry in the
texinfo source:
	@dircategory Package short info
	@direntry
	* menu item 1: (infofile).		Description.
	* menu item 2: (infofile2).		Description.
	@end direntry
In the experimental package we still let the above warnings go through,
but with an upload to unstable they will be probably supressed.

Can you please add an info dir entry to the texinfo files of your package
to fix these warnings.

If you have any questions please see the texinfo manual available in info 
format in texinfo-doc-nonfree, chapter 21 Creating and Installing Info Files,
and do not hesitate to contact us at
	debian-tex-maint@lists.debian.org

Thanks a lot and all the best

Norbert Preining
texinfo maintainer
----------------------------------------------------------

Best wishes

Norbert

-------------------------------------------------------------------------------
Dr. Norbert Preining <preining@logic.at>        Vienna University of Technology
Debian Developer <preining@debian.org>                         Debian TeX Group
gpg DSA: 0x09C5B094      fp: 14DF 2E6C 0307 BE6D AD76  A9C0 D2BF 4AA3 09C5 B094
-------------------------------------------------------------------------------
QUEDGELEY (n.)
A rabidly left-wing politician who can afford to be that way because
he married a millionairess.
			--- Douglas Adams, The Meaning of Liff