Bug#139569: #139569: patch: info patch doesn't lead to the info docs
> Date: Tue, 26 Mar 2002 12:30:58 +0100 (CET)
> From: Santiago Vila <sanvila@unex.es>
> Reply from Adam Heath, dpkg maintainer:
>
> > Well, first off, dpkg's install-info will only process one
> > START-INFO-DIR-ENTRY section per file.
Thanks for mentioning this porting problem. However, I see that
several other packages have more than one START-INFO-DIR-ENTRY section
per file. These include Automake, Autoconf, Gawk, Libtool, and Tar.
So I guess a similar problem must occur with these other packages.
GNU Texinfo 4.1 documents the fact that a Texinfo file can contain
more than one set of @direntry/@dircategory commands. Hence it
appears that multiple START-INFO-DIR-ENTRY sections per file are
supported by GNU Texinfo install-info.
> > 'Diff: (diff). Comparing and merging files.\n'
> >
> > my question is, is not having the leading * valid?
Apparently not. Thanks for catching this bug. However, this alone
does not resolve the problem on my Debian host, partly because of the
START-INFO-DIR-ENTRY issue mentioned above. To work around that
issue, I'll move the Individual utilities dircategory before the GNU
packages dircategory. That way, when Debian install-info ignores the
second and succeeding START-INFO-DIR-ENTRY section, it will ignore the
less important section.
Here is a patch to address these two issues for Diffutils. However,
even with this patch, one direntry will be ignored. Also, "make install"
will still avoid invoking install-info, since Automake-generated
makefiles purposely avoid Debian install-info. I assume you're used
to working around this by hand, but there must be a better way.
2002-03-26 Paul Eggert <eggert@twinsun.com>
* doc/diff.texi (dircategory GNU packages): Fix typo: a "* " was
missing before the menu entry. Bug diagnosed by Adam Heath.
Also, put this dircategory after the Individual utilities dircategory,
to work around a compatibility problem with Debian install-info.
--- doc/diff.texi 2002/03/24 07:50:25 1.21
+++ doc/diff.texi 2002/03/26 19:49:24
@@ -9,11 +9,8 @@
@syncodeindex vr cp
-@dircategory GNU packages
-@direntry
-Diff: (diff). Comparing and merging files.
-@end direntry
-
+@c Debian install-info (up through at least version 1.9.20) uses only the
+@c first dircategory. Put this one first, as it is more useful in practice.
@dircategory Individual utilities
@direntry
* cmp: (diff)Invoking cmp. Compare 2 files byte by byte.
@@ -23,6 +20,11 @@ Diff: (diff). Comparing
* sdiff: (diff)Invoking sdiff. Merge 2 files side-by-side.
@end direntry
+@dircategory GNU packages
+@direntry
+* Diff: (diff). Comparing and merging files.
+@end direntry
+
@ifinfo
This file documents the @sc{gnu} @command{diff}, @command{diff3},
@command{sdiff}, and @command{cmp} commands for showing the
--
To UNSUBSCRIBE, email to debian-dpkg-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: