From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-ej1-x62e.google.com (mail-ej1-x62e.google.com [IPv6:2a00:1450:4864:20::62e]) by sourceware.org (Postfix) with ESMTPS id D0F8C3857022 for ; Mon, 3 Oct 2022 08:23:28 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org D0F8C3857022 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-ej1-x62e.google.com with SMTP id rk17so20504640ejb.1 for ; Mon, 03 Oct 2022 01:23:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date; bh=lq9C+lZuJhFJW9mVNF3djOW8TjBJ+UmDunx2fXOdH1M=; b=YnPulfiiPAQh6es37g1Oq4g4l2WZ9oqovqF/xbE3p6NNxCeuBm1Zd6bADBWzyG+zES wyOF34O4XP/Qm53O5FcLAE0QXbZvzq7/avMYcXglYm/7dQSthtNQzLes7iRiGPVGL92d a7O5eGndYpcy0C73/Ux7Ke6k/Do1eB8eReMfQCWr/9bd8ZGjr4FMfT5opM7Q6N+cTACu wYtsZWZqFHyxgQGHHCn2fh9oHq6R5wy3dK8gjjlJ+veAsF0NyVuT3HGiI62p+Mb5L61q bqc5TNGbSECRYLDXizjivbbODMnBaINHNOUiX1bscKFx0vdC99MiOgeCI3xls19A0Zkn vu5w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-message-state:from:to:cc:subject:date; bh=lq9C+lZuJhFJW9mVNF3djOW8TjBJ+UmDunx2fXOdH1M=; b=cGjMamUbgWaN1hr2AixOvJ0wPcxojzRukufdB+KWPqwGLcTrwcl4eUEk5GpasiSSwY vXP/qaoux9U5NGr3I9Mj7kMIaELB7TDNkevc8qhXmtwsSO45tSUY8QUJIJMaN/KZyKzW gGgMzxofDychIebk4YzhmMpXQXNQqqAek6rXn/d8R9BcWyLlhbMKXoO06/93MQ2kRtIZ V+lOHWBbwVwTUlXSaZNO89WGxzF1NvYsc1xv77+eqIH4PuNu9Kix0lPHba0/SBHqzDcT H6etM4d4NV60duDtY+B+YsSTspwKseZ0jUK6o1a3FQiCpQRmJE1iUVykItpHey+Qc3Wh JTrg== X-Gm-Message-State: ACrzQf2gW+JWLNevD1+4kvqanjX6E/x5Ctvyx055DRNuc4Adh0WF+3oe L7uxs/haXqsmfqIyvrCwrxYhKTl80IC4fDgQ9fQ= X-Google-Smtp-Source: AMsMyM7Z3qqDLEUXTbXTXMEzt6cHG8q/Qo7QrVOJ8nxARGQDP1xp0DBXwyr+DB2pPEECgjX/tV76SXeXYlsLg1ZzbY0= X-Received: by 2002:a17:906:fd8a:b0:75d:c79a:47c8 with SMTP id xa10-20020a170906fd8a00b0075dc79a47c8mr13939321ejb.389.1664785407349; Mon, 03 Oct 2022 01:23:27 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Jonathan Wakely Date: Mon, 3 Oct 2022 09:23:16 +0100 Message-ID: Subject: Re: Makeinfo generates wrong link To: Gavin Smith , Richard Stallman , Texinfo , "gcc@gcc.gnu.org" Content-Type: multipart/alternative; boundary="000000000000d5161405ea1d0e74" X-Spam-Status: No, score=-0.2 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,HTML_MESSAGE,KAM_SHORT,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --000000000000d5161405ea1d0e74 Content-Type: text/plain; charset="UTF-8" On Mon, 3 Oct 2022, 08:31 Jonathan Wakely, wrote: > On Mon, 3 Oct 2022 at 07:01, Gavin Smith via Gcc wrote: > > > > On Sun, Oct 02, 2022 at 09:06:06PM -0400, Richard Stallman wrote: > > > generates the following output: > > > > > >
  • Some macros are predefined on each kind of machine > > > (see System-specific > Predefined Macros in Using the GNU Compiler > > > Collection). This allows you to provide code specially > tuned for a > > > particular machine. > > > > > > but that link is broken. The OP suggests this link > > > > > > > https://gcc.gnu.org/onlinedocs/gcc-4.8.5/cpp/System-specific-Predefined-Macros.html > > > > > > may be correct. > > > > > > Where do those directory names come from? Is there a table in makeinfo > > > that needs to be updated? > > > > > > It comes from the htmlxref.cnf file. (It may be installed under > > /usr/share/texinfo/.) The link produced above matches the > > current entry for the "gcc" manual in that file. > > > > Changing that file would change the link, e.g. > > > > --- a/util/htmlxref.cnf > > +++ b/util/htmlxref.cnf > > @@ -340,7 +340,7 @@ gcal mono > ${GS}/gcal/manual/gcal.html > > gcal node ${GS}/gcal/manual/html_node/ > > > > GCC = https://gcc.gnu.org/onlinedocs > > -gcc node ${GCC}/gcc/ > > +gcc node ${GCC}/gcc-4.8.5/ > > cpp node ${GCC}/cpp/ > > gfortran node ${GCC}/gfortran/ > > gnat_rm node ${GCC}/gnat_rm/ > > > > > > However, it's wrong to make it link to a specific version. > > > > The gcc developers need to provide a stable, version-independent link > > for the manual. This link would have worked in the past, but I don't > > know how recently it broke. > > The URL > https://gcc.gnu.org/onlinedocs/cpp/System-specific-Predefined-Macros.html > has been stable for many years. > Although in general the gcc.gnu.org/onlinedocs/gcc/... and gcc.gnu.org/onlinedocs/cpp/... pages are for the development trunk, and so they can change e.g. when texinfo changes how it escapes non-ASCII characters in output filenames, or when sections of the manual are renamed or removed (which isn't common, but is possible). If you want a stable URL, consider linking to a specific release not the development trunk (but gcc-4.8.5 seems like a poor choice given its antiquity). Otherwise, if you do want to link from an external site to something in the development trunk docs, at least let the GCC project know so that we can try to put redirects in place if/when that URL changes. > > > > > I'm attempting to CC the gcc mailing list stated on their documentation > page > > to see if anyone there can give any information. > --000000000000d5161405ea1d0e74--