From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10599 invoked by alias); 21 Jul 2015 15:09:35 -0000 Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Received: (qmail 10587 invoked by uid 89); 21 Jul 2015 15:09:35 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.1 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_LOW,SPF_PASS autolearn=ham version=3.3.2 X-HELO: relay1.mentorg.com Received: from relay1.mentorg.com (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 21 Jul 2015 15:09:33 +0000 Received: from svr-orw-fem-05.mgc.mentorg.com ([147.34.97.43]) by relay1.mentorg.com with esmtp id 1ZHZAf-0003ra-S3 from Sandra_Loosemore@mentor.com ; Tue, 21 Jul 2015 08:09:29 -0700 Received: from [IPv6:::1] (147.34.91.1) by svr-orw-fem-05.mgc.mentorg.com (147.34.97.43) with Microsoft SMTP Server id 14.3.224.2; Tue, 21 Jul 2015 08:09:28 -0700 Message-ID: <55AE603D.10807@codesourcery.com> Date: Tue, 21 Jul 2015 15:37:00 -0000 From: Sandra Loosemore User-Agent: Mozilla/5.0 (X11; Linux i686; rv:17.0) Gecko/20130329 Thunderbird/17.0.5 MIME-Version: 1.0 To: Jonathan Wakely CC: , Gerald Pfeifer Subject: Re: [doc patch] Rename "Language Independent Options" @node in invoke.texi References: <20150721125201.GR21787@redhat.com> In-Reply-To: <20150721125201.GR21787@redhat.com> Content-Type: text/plain; charset="ISO-8859-1"; format=flowed Content-Transfer-Encoding: 7bit X-SW-Source: 2015-07/txt/msg01766.txt.bz2 On 07/21/2015 06:52 AM, Jonathan Wakely wrote: > This texinfo @node seems misnamed: > https://gcc.gnu.org/onlinedocs/gcc/Language-Independent-Options.html#Language-Independent-Options > > > It should be something like "Diagnostic Message Formatting Options" > not "Language Independent Options". > > The misnomer makes the TOC and navbar confusing and seems to suggest > that warning and debuging options are not language independent, since > they're not part of that node. See > https://gcc.gnu.org/onlinedocs/gcc/Invoking-GCC.html#Invoking-GCC > which has: > > * Language Independent Options: Controlling how diagnostics should be > formatted. > * Warning Options: How picky should the compiler be? > * Debugging Options: Symbol tables, measurements, and debugging dumps. > * Optimize Options: How much optimization? > The title of the first entry is completely unrelated to its > description. > > An alternative fix would be to keep a "Language Independent Options" > node but nest "Diagnostic Message Formatting Options", "Warning > Options", "Debugging Options" and "Optimize Options" as sub-sections > of it. The downside of that is that it would be harder to find those > sub-sections from the > https://gcc.gnu.org/onlinedocs/gcc/Invoking-GCC.html#Invoking-GCC > node, as you'd have to click through to another page to see the > sub-sections. > > OK for trunk? I agree with the proposed renaming of the node, but you need to fix all the references to the old name and not just the @node, so no, the patch is not OK as-is. -Sandra