[rfa/doc/branch too] Texinfo problems

[rfa/doc/branch too] Texinfo problems

[Daniel Jacobowitz]

While building Debian gdb packages, I ran into two problems.  One is, I
think, a problem in Debian's tools rather than gdb; the line:

@dircategory Programming & development tools.

gets munged.  I assume & is a legal character here?  I don't know much about
texinfo.  In any case, Debian happens to use Development, so I'll just
override that.

What's more annoying is this:

install-info --quiet --section 'Programming #SECTION# development tools.'
    'Programming #SECTION# development tools.' /usr/share/info/gdbint.info
install-info: warning, ignoring confusing INFO-DIR-ENTRY in file.

I think the patch below is correct.  OK to commit, trunk and branch?

-- 
Daniel Jacobowitz                           Carnegie Mellon University
MontaVista Software                         Debian GNU/Linux Developer

2001-07-30  Daniel Jacobowitz  <drow@mvista.com>

	* gdbint.texinfo: Remove extraneous START-INFO-DIR-ENTRY
	and END-INFO-DIR-ENTRY.

Index: gdbint.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdbint.texinfo,v
retrieving revision 1.32
diff -u -r1.32 gdbint.texinfo
--- gdbint.texinfo      2001/07/24 10:35:42     1.32
+++ gdbint.texinfo      2001/07/30 19:04:14
@@ -3,9 +3,7 @@
 @include gdb-cfg.texi
 @dircategory Programming & development tools.
 @direntry
-START-INFO-DIR-ENTRY
 * Gdb-Internals: (gdbint).     The GNU debugger's internals.
-END-INFO-DIR-ENTRY
 @end direntry

 @ifinfo

Re: [rfa/doc/branch too] Texinfo problems

[Eli Zaretskii]

On Mon, 30 Jul 2001, Daniel Jacobowitz wrote:

> While building Debian gdb packages, I ran into two problems.  One is, I
> think, a problem in Debian's tools rather than gdb; the line:
> 
> @dircategory Programming & development tools.
> 
> gets munged.

How does it get munged?

> I assume & is a legal character here?

The Texinfo manual doesn't say anything about characters that are
invalid in @dircategory, and I don't see anything in makeinfo's code
which would treat & specially, except maybe under --html.

> In any case, Debian happens to use Development

I don't understand that: what ``Development'' did you refer to here?

What does "makeinfo --version" print?

> install-info --quiet --section 'Programming #SECTION# development tools.'
>     'Programming #SECTION# development tools.' /usr/share/info/gdbint.info
> install-info: warning, ignoring confusing INFO-DIR-ENTRY in file.
> 
> I think the patch below is correct.  OK to commit, trunk and branch?

Yes, thanks.

> -- 
> Daniel Jacobowitz                           Carnegie Mellon University
> MontaVista Software                         Debian GNU/Linux Developer
> 
> 2001-07-30  Daniel Jacobowitz  <drow@mvista.com>
> 
> 	* gdbint.texinfo: Remove extraneous START-INFO-DIR-ENTRY
> 	and END-INFO-DIR-ENTRY.
> 
> Index: gdbint.texinfo
> ===================================================================
> RCS file: /cvs/src/src/gdb/doc/gdbint.texinfo,v
> retrieving revision 1.32
> diff -u -r1.32 gdbint.texinfo
> --- gdbint.texinfo      2001/07/24 10:35:42     1.32
> +++ gdbint.texinfo      2001/07/30 19:04:14
> @@ -3,9 +3,7 @@
>  @include gdb-cfg.texi
>  @dircategory Programming & development tools.
>  @direntry
> -START-INFO-DIR-ENTRY
>  * Gdb-Internals: (gdbint).     The GNU debugger's internals.
> -END-INFO-DIR-ENTRY
>  @end direntry
> 
>  @ifinfo
> 

Re: [rfa/doc/branch too] Texinfo problems

[Daniel Jacobowitz]

On Tue, Jul 31, 2001 at 11:40:18AM +0300, Eli Zaretskii wrote:
> 
> On Mon, 30 Jul 2001, Daniel Jacobowitz wrote:
> 
> > While building Debian gdb packages, I ran into two problems.  One is, I
> > think, a problem in Debian's tools rather than gdb; the line:
> > 
> > @dircategory Programming & development tools.
> > 
> > gets munged.
> 
> How does it get munged?

Through stupid perl mistakes :)  & in a regex is special, and someone
isn't quoting properly.  & gets replaced by #SECTION#.  It's not gdb's
fault, but Debian's.

> > I assume & is a legal character here?
> 
> The Texinfo manual doesn't say anything about characters that are
> invalid in @dircategory, and I don't see anything in makeinfo's code
> which would treat & specially, except maybe under --html.
> 
> > In any case, Debian happens to use Development
> 
> I don't understand that: what ``Development'' did you refer to here?

As opposed to Programming & Development.  By default our info tools
pick the section out of the file, but I need to override it in my hat
as Debian packager in order to put it in the right place.

In other words, none of the above is a problem with GDB.

> > install-info --quiet --section 'Programming #SECTION# development tools.'
> >     'Programming #SECTION# development tools.' /usr/share/info/gdbint.info
> > install-info: warning, ignoring confusing INFO-DIR-ENTRY in file.
> > 
> > I think the patch below is correct.  OK to commit, trunk and branch?
> 
> Yes, thanks.

OK, committing.

-- 
Daniel Jacobowitz                           Carnegie Mellon University
MontaVista Software                         Debian GNU/Linux Developer