From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-bugzilla@gcc.gnu.org>
Received: by sourceware.org (Postfix, from userid 48)
	id 60A153858D35; Tue, 16 Apr 2024 09:20:17 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 60A153858D35
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org;
	s=default; t=1713259217;
	bh=gnUE+tn3rKb9RAseO/AUXDZR+ma/Hv+n/1k99CwblLo=;
	h=From:To:Subject:Date:From;
	b=OXJO6brU0IbzUP7smDNf3pW0y/wPR0T38gMgEO1i0XVl1ozn7cya2OsCu6K0dsL1I
	 iYoE3EvEjjVUtxgSXgLFfNyAnIG8bqHQaK8B7O/AcHi9BG/4QZkIoY1bzcSiL6TfrL
	 lxOmGOmM/LkFG6eDO9NTmItvShkzM3QnngwENLxg=
From: "jakub at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug other/114738] New: [14 Regression] Default
 DOCUMENTATION_ROOT_URL vs. release branches
Date: Tue, 16 Apr 2024 09:20:16 +0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: other
X-Bugzilla-Version: 14.0
X-Bugzilla-Keywords: 
X-Bugzilla-Severity: normal
X-Bugzilla-Who: jakub at gcc dot gnu.org
X-Bugzilla-Status: UNCONFIRMED
X-Bugzilla-Resolution: 
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: unassigned at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: bug_id short_desc product version bug_status
 bug_severity priority component assigned_to reporter target_milestone
Message-ID: <bug-114738-4@http.gcc.gnu.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Bugzilla-URL: http://gcc.gnu.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
List-Id: <gcc-bugs.sourceware.org>

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=3D114738

            Bug ID: 114738
           Summary: [14 Regression] Default DOCUMENTATION_ROOT_URL vs.
                    release branches
           Product: gcc
           Version: 14.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: other
          Assignee: unassigned at gcc dot gnu.org
          Reporter: jakub at gcc dot gnu.org
  Target Milestone: ---

gcc/configure.ac uses DOCUMENTATION_ROOT_URL=3D"https://gcc.gnu.org/onlined=
ocs/"
as the default documentation root.  That is great for the trunk, but I'm not
convinced
it is the right thing for release branches.  The online docs at that locati=
on
are updated daily from the trunk, while the release branches will be suppor=
ted
for ~ 3 years, during which a lot of the URLs hardcoded into the releases or
snapshots on release branches might get removed, the documentation changed =
etc.
Another option would be to switch that default on release branches to
docrootbase=3D
case "$gcc_version" in
*.[123456].0) docrootbase=3D"$gcc_version/";;
*.[123456].1) docrootbase=3D"`echo $gcc_version | sed 's/1$/0$/'`/";;
esac
DOCUMENTATION_ROOT_URL=3D"https://gcc.gnu.org/onlinedocs/$docrootbase"
or so.  That has the advantage that the URLs will reflect the corresponding
release's stable documentation for the 3 years (or even after it goes out of
support).
The disadvantage is that unlike the trunk online docs regenerated every day,
the release onlinedocs are only created when release is made.
So, say 14.1.0 docs will be correct, but if something in the docs or in the
options is changed in 14.1.1 between 14.1.0 and 14.2.0, the URLs on the rel=
ease
branches might be stale.=