> Date: Tue, 26 Mar 2002 12:30:58 +0100 (CET)
> From: Santiago Vila <[EMAIL PROTECTED]>

> 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  <[EMAIL PROTECTED]>

        * 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
 
[EMAIL PROTECTED] GNU packages
[EMAIL PROTECTED]
-Diff: (diff).                 Comparing and merging files.
[EMAIL PROTECTED] direntry
-
[EMAIL PROTECTED] Debian install-info (up through at least version 1.9.20) uses 
only the
[EMAIL PROTECTED] 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
 
[EMAIL PROTECTED] GNU packages
[EMAIL PROTECTED]
+* Diff: (diff).                 Comparing and merging files.
[EMAIL PROTECTED] 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 [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]


Reply via email to