This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH, doc]: Rename Index node to prevent file collision
> From: Michael Hope <michael.hope@linaro.org>
> Date: Fri, 22 Jun 2012 10:36:02 +1200
> Cc: brobecker@adacore.com, joseph@codesourcery.com, gdb-patches@sourceware.org
>
> >> > I fail to understand why working around by changes in one file
> >> > (gdb.texinfo) is acceptable, but working around in another file
> >> > (makeinfo's source) is not. ?I guess I'm missing something.
> >>
> >> GDB is an active project. ?Even if makeinfo was alive, it's nice to be
> >> able to use the tools already shipped with long term releases like
> >> Ubuntu 10.04.
> >
> > Texinfo is actively maintained as well.
>
> The last release was four years ago. The list has around five threads
> a month. The ChangeLog shows recent development by Karl.
I don't see how this matters, when you have a publicly accessible CVS
repository. What's important is that there are 3 active developers
who are responsive to questions and bug reports.
> I'm happy to post a patch to makeinfo similar to
> http://sourceware.org/ml/gdb-patches/2012-06/msg00496.html. I'll do
> that next as another avenue.
Thank you.
> >> > The problem with your suggestion is that the GDB index is not a
> >> > concept index, it is all the indices lumped into one. ?But I would be
> >> > OK if we separate the concept index from the rest, and then we could
> >> > have "Concept Index" and "Command and Variable Index".
> >>
> >> I'd rather not go there as it's a big change for little gain.
> >
> > ??? It's as simple as modifying the "@syncodeindex" directives at the
> > beginning of gdb.texinfo, and then adding 2 @node lines for the two
> > indices, instead of the current one. ?All the rest will be done by
> > makeinfo. ?Am I missing something?
>
> Sorry, I assumed that we'd have to check and perhaps update each index
> entry to see that it's in the right category.
No. We already have separate index categories: see the @kindex,
@findex, @vindex, etc. directives, in addition to @cindex, that we
have all over the manual. It's just that these 4 directives at the
beginning of gdb.texinfo:
@syncodeindex ky cp
@syncodeindex tp cp
@c readline appendices use @vindex, @findex and @ftable,
@c annotate.texi and gdbmi use @findex.
@syncodeindex vr cp
@syncodeindex fn cp
arrange for all of them to be lumped into a single index "cp" (which
stands for "Concept Index"), and so this directive in the single
"Index" node we have:
@printindex cp
prints all of the index entries together.
> Your texinfo foo is better than mine - could you post a patch?
OK.
- References:
- [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision
- Re: [PATCH, doc]: Rename Index node to prevent file collision