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

[Daniel Jacobowitz <drow at mvista dot com>]

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