From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-return-198708-listarch-gcc=gcc.gnu.org@gcc.gnu.org>
Received: (qmail 39165 invoked by alias); 4 Apr 2019 10:11:14 -0000
Mailing-List: contact gcc-help@gcc.gnu.org; run by ezmlm
Precedence: bulk
List-Id: <gcc.gcc.gnu.org>
List-Archive: <http://gcc.gnu.org/ml/gcc/>
List-Post: <mailto:gcc@gcc.gnu.org>
List-Help: <http://gcc.gnu.org/ml/>
Sender: gcc-owner@gcc.gnu.org
Received: (qmail 39157 invoked by uid 89); 4 Apr 2019 10:11:13 -0000
Authentication-Results: sourceware.org; auth=none
X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00,FREEMAIL_FROM,KAM_SHORT,RCVD_IN_DNSWL_NONE,SPF_PASS autolearn=ham version=3.3.1 spammy=H*f:sk:8L3QWMp, H*f:CAMfD, H*i:sk:8L3QWMp, H*i:CAMfD
X-HELO: mail-wm1-f52.google.com
Received: from mail-wm1-f52.google.com (HELO mail-wm1-f52.google.com) (209.85.128.52) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 04 Apr 2019 10:11:12 +0000
Received: by mail-wm1-f52.google.com with SMTP id r186so6931195wmf.1        for <gcc@gcc.gnu.org>; Thu, 04 Apr 2019 03:11:12 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=gmail.com; s=20161025;        h=mime-version:references:in-reply-to:from:date:message-id:subject:to         :cc;        bh=Y26kxSJNfUt8pYAd663XZtTsHPb1XXDjHLofDGiWF6s=;        b=oU6gYFUSJlzLHOvNZD9G26KWFO5YIqhF64sQItNubVX2QBhBfc3Dj/E3ORcENPIZmU         PmhMhRk82pgWelzB095CB46oaiKJS+8arDrGFvEYXvMDhsb0qNAI3kGcS7fz08pqCeI4         TQY4PvbTDLcoqnqoMnOFcCtnd8agdCMq1ZgTzV6uxevJsZNToNOJ66ui08zMauyNsRhG         TSArlfVf+WT8pWBlfhM5/zv1VMQ71TtD4d5NBuYapFSPKa883dXgZnqgTpEfjl64ALzR         oipOMagQlDAHY+12wVygIhaSeKYxFL4tj06nrgxPmYDuCpBtaj1Saz97KFlQ57CDTu8w         Tv0w==
MIME-Version: 1.0
References: <CAMfD+8L3QWMpCHtxgT5BpnUcTQxcu4X8rP6kwXRXbV6CaVjecQ@mail.gmail.com>
In-Reply-To: <CAMfD+8L3QWMpCHtxgT5BpnUcTQxcu4X8rP6kwXRXbV6CaVjecQ@mail.gmail.com>
From: Jonathan Wakely <jwakely.gcc@gmail.com>
Date: Thu, 04 Apr 2019 10:11:00 -0000
Message-ID: <CAH6eHdTweVbgAZcHYx2KdGJWDHY9sYwKetjgE+fC4KWNzOBz+w@mail.gmail.com>
Subject: Re: Show name of compiler options when linking
To: Peter Olsson <peterdenbra@gmail.com>
Cc: "gcc@gcc.gnu.org" <gcc@gcc.gnu.org>
Content-Type: text/plain; charset="UTF-8"
X-IsSubscribed: yes
X-SW-Source: 2019-04/txt/msg00053.txt.bz2

On Thu, 4 Apr 2019 at 10:56, Peter Olsson wrote:
>
> Hello,
>
> I often want to link to specific compiler options in your online docs
> but the problem is that the named anchors are placed after the name of
> the option so when the link is clicked it will only show the
> description.
>
> Example:
>   https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html#index-Wshadow
>   Will show the description for -Wshadow but not the name -Wshadow itself.
>
> I think it would be very useful to be able to link in such a way that
> the name of the option also becomes visible. If this somehow breaks
> backwards compatibility you could introduce new ones that refers to
> the name and let the old ones refer to the description like it is
> today.

Yes, it's annoying. The HTML is auto-generated by the makeinfo
program, so as far as I know we don't have much control over the
placement of those anchors.