Re: Bug#528905: please add info-dir-section to your info files
Norbert Preining <preining@logic.at> writes:
> 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 (see http://wiki.debian.org/Transitions/DpkgToGnuInstallInfo
> for details).
Great!
> 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
> libidn11-dev
> because the files:
> usr/share/info/libidn-components.png
> do not ship info dir sections. Thus, 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
The file above is an image, thus adding that information will be
difficult. However I don't think that is needed.
I asked Karl about where to place images for Info files, and his
recommendation was (if I recall correctly) to name them as
INFOFILE-IMAGENAME.png, replacing INFILEFILE with 'libidn' in this case.
Since Info supports images in documentation, it seems like you want to
discuss this aspect?
I suspect you can simply add a regexp to only run install-info on files
matching *.info.gz, or something like that.
/Simon
Reply to: