From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26332 invoked by alias); 22 Jun 2012 10:03:02 -0000 Received: (qmail 26297 invoked by uid 22791); 22 Jun 2012 10:03:01 -0000 X-SWARE-Spam-Status: No, hits=-3.9 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,RCVD_IN_NIX_SPAM,SPF_SOFTFAIL X-Spam-Check-By: sourceware.org Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 22 Jun 2012 10:02:48 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0M6000C00JRSPC00@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Fri, 22 Jun 2012 13:02:45 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.210.75]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0M6000CZXJWLEV70@a-mtaout22.012.net.il>; Fri, 22 Jun 2012 13:02:45 +0300 (IDT) Date: Fri, 22 Jun 2012 10:03:00 -0000 From: Eli Zaretskii Subject: Re: [PATCH, doc]: Rename Index node to prevent file collision In-reply-to: <83a9zvdh1g.fsf@gnu.org> To: michael.hope@linaro.org Cc: brobecker@adacore.com, joseph@codesourcery.com, gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <837guzd5q1.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=iso-8859-1 Content-transfer-encoding: 8BIT References: <4FD94EC0.1000009@linaro.org> <83ehphyhdn.fsf@gnu.org> <20120614220037.GO18729@adacore.com> <83txydf2nj.fsf@gnu.org> <83lijle3fu.fsf@gnu.org> <83ipekd496.fsf@gnu.org> <83a9zvdh1g.fsf@gnu.org> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2012-06/txt/msg00686.txt.bz2 > Date: Fri, 22 Jun 2012 08:58:19 +0300 > From: Eli Zaretskii > Cc: brobecker@adacore.com, joseph@codesourcery.com, gdb-patches@sourceware.org > > > >> > 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. Here it is. Does this solve your problem? Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.978 diff -u -p -r1.978 gdb.texinfo --- gdb.texinfo 22 Jun 2012 08:37:49 -0000 1.978 +++ gdb.texinfo 22 Jun 2012 10:01:35 -0000 @@ -18,13 +18,17 @@ @end iftex @finalout -@syncodeindex ky cp -@syncodeindex tp cp +@c To avoid file-name clashes between index.html and Index.html, when +@c the manual is produced on a Posix host and then moved to a +@c case-insensitive filesystem (e.g., MS-Windows), we separate the +@c indices into two: Concept Index and all the rest. +@syncodeindex ky fn +@syncodeindex tp fn @c readline appendices use @vindex, @findex and @ftable, @c annotate.texi and gdbmi use @findex. -@syncodeindex vr cp -@syncodeindex fn cp +@syncodeindex vr fn +@syncodeindex fn fn @c !!set GDB manual's edition---not the same as GDB version! @c This is updated by GNU Press. @@ -182,7 +186,9 @@ software in general. We will miss him. * Copying:: GNU General Public License says how you can copy and share GDB * GNU Free Documentation License:: The license for this documentation -* Index:: Index +* Concept Index:: Index of @value{GDBN} concepts +* Command and Variable Index:: Index of @value{GDBN} commands, variables, + functions, and Python data types @end menu @end ifnottex @@ -1780,8 +1786,9 @@ In addition to @code{help}, you can use and @code{show} to inquire about the state of your program, or the state of @value{GDBN} itself. Each command supports many topics of inquiry; this manual introduces each of them in the appropriate context. The listings -under @code{info} and under @code{show} in the Index point to -all the sub-commands. @xref{Index}. +under @code{info} and under @code{show} in the Command, Variable, and +Function Index point to all the sub-commands. @xref{Command and Variable +Index}. @c @group @table @code @@ -40415,11 +40422,16 @@ A string in the constant pool is zero-te @appendix GNU Free Documentation License @include fdl.texi -@node Index -@unnumbered Index +@node Concept Index +@unnumbered Concept Index @printindex cp +@node Command and Variable Index +@unnumbered Command, Variable, and Function Index + +@printindex fn + @tex % I think something like @@colophon should be in texinfo. In the % meantime: