From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 666 invoked by alias); 21 Jun 2012 04:20:28 -0000 Received: (qmail 654 invoked by uid 22791); 21 Jun 2012 04:20:22 -0000 X-SWARE-Spam-Status: No, hits=-3.1 required=5.0 tests=AWL,BAYES_00,KHOP_RCVD_UNTRUST,KHOP_THREADED,RCVD_IN_DNSWL_LOW,RCVD_IN_HOSTKARMA_YE X-Spam-Check-By: sourceware.org Received: from mail-wg0-f43.google.com (HELO mail-wg0-f43.google.com) (74.125.82.43) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 21 Jun 2012 04:20:10 +0000 Received: by wgbdr1 with SMTP id dr1so126455wgb.12 for ; Wed, 20 Jun 2012 21:20:08 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:content-transfer-encoding:x-gm-message-state; bh=fpe/+rjOXPuUwzY4J/eR9xfK90qyYcuLBb7pFdf3i/U=; b=MabBu2ek1Qf4PJb4jAmmJ36/9i7pceflg1bb0nX+Wd2fzW+x3MPiPW8zPmfsId8C95 0aUop/eVGfsuigyxkPw+Jx03dS2UwSczIY3vVArM7ow25IEYCeAjiKJbvip48S22r6XL M8+J+WtUsD67iPvKHqGD9EzLwhmYU2LRaORyFEkoF4IY2jUTY5e93KmQKZAMB1FUihTp m+32bQByw1UMi+XC0pH1HA3Ngb+BrPTMR7Cha1NaNCRkgHxGhhBpClMx8slyL4TS+3Ru iu5G3IMC1KgxZ9gENGtxORK67z0KxYhv3ZnkuwiRXZO11I4HhFVpaH5wMqgiyFWsbwxf IgFw== Received: by 10.180.93.196 with SMTP id cw4mr16767778wib.11.1340252408588; Wed, 20 Jun 2012 21:20:08 -0700 (PDT) MIME-Version: 1.0 Received: by 10.180.87.225 with HTTP; Wed, 20 Jun 2012 21:19:48 -0700 (PDT) In-Reply-To: <83lijle3fu.fsf@gnu.org> References: <4FD94EC0.1000009@linaro.org> <83ehphyhdn.fsf@gnu.org> <20120614220037.GO18729@adacore.com> <83txydf2nj.fsf@gnu.org> <83lijle3fu.fsf@gnu.org> From: Michael Hope Date: Thu, 21 Jun 2012 04:20:00 -0000 Message-ID: Subject: Re: [PATCH, doc]: Rename Index node to prevent file collision To: Eli Zaretskii Cc: brobecker@adacore.com, joseph@codesourcery.com, gdb-patches@sourceware.org Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Gm-Message-State: ALoCoQmq2t+1nAgnBg9ygZIqW2/mziAzK6EVR90r8FRHXF7UvaCtIHb9HallHWXcv3NkbyTzkZ/G 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/msg00651.txt.bz2 On 18 June 2012 14:53, Eli Zaretskii wrote: >> From: Michael Hope >> Date: Mon, 18 Jun 2012 11:26:04 +1200 >> Cc: Joel Brobecker , joseph@codesourcery.com, >> =A0 =A0 =A0 gdb-patches@sourceware.org >> >> Changing the node name works around a tools problem and makes the >> output the same for all hosts. > > 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. =A0I 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. I'd argue that if there's a tool problem we fix it in the tool and, if the workaround is tidy and has no ongoing cost, work around it in GDB as well. >> I agree that 'Index' is more natural than 'GDB Index'. =A0How about >> matching GCC, and call it the 'Concept Index' instead? > > (I wouldn't take example from GCC in any documentation-related area, > if you catch my drift. =A0I can never find anything there. =A0I hope the > GDB manual is better.) Renaming the node doesn't affect the content or findability of the documentation. > The problem with your suggestion is that the GDB index is not a > concept index, it is all the indices lumped into one. =A0But 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. There's a few options so far: 1. Leave it and have many groups with many hack arounds (ergh) 2. Match bintuils and rename to 'GDB Index' (not natural) 3. Match GCC and rename to 'Concept Index' (strictly true but confusing) 4. Wait for makeinfo to be re-written and released 5. Rewrite the filenames after generation The last is what we currently do: build on a case sensitive filesystem, rename Index.html to Index_.html, and use sed to rewrite the links in all other files. This keeps the text the same and doesn't require a change to makeinfo, but is a hack. Shall I send a patch? -- Michael