From patchwork Tue Jun 25 23:02:32 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 1952304 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=ReBqDNAB; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=8.43.85.97; helo=server2.sourceware.org; envelope-from=gcc-patches-bounces+incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=patchwork.ozlabs.org) Received: from server2.sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4W80y05L5Rz20X6 for ; Wed, 26 Jun 2024 09:13:42 +1000 (AEST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 9743F387093C for ; Tue, 25 Jun 2024 23:13:39 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id F224838708FC for ; Tue, 25 Jun 2024 23:12:50 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org F224838708FC Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org F224838708FC Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1719357172; cv=none; b=uz/4hcgf6J6g5cQtgSZQXCEDsrtQWwu5pNrivqQguK6pt0PJ/O7Oyfwk13xdK/FP2gOP/lTDkpUZ99PK2OR6l9Xh2Fg/97ngMISsFO4fF90vpe6Bx8N9IDFtQJbXm83PMZ+QYikWeSuJMsgj6vCgGL05SpJ91Pz8ZZZu4SOqMCw= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1719357172; c=relaxed/simple; bh=oRnxFbG6+VI3wMTp2B9HrAQODFlqhzp1QbRvcJA2HWY=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=a/d1jVVHfey5uwsMM0LK5bpYPmpF2iERSbdAWcele9pT3yeTKErwcKuIw9aRWIiJ+/AhSJVXI/wy1e3CI/vHTpDlfGtkAn+yyUbGA1rKy3sWmf3hYKEkAXFRsjiF2FP9q1cWUvov8Wp7p7zhk2Y+ib2es5GPpcE+6mmH5FEr0cw= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1719357170; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=6hBTPOkXEmSmZvKy+Ec458FyuYko+MxKQO/U4jF1Ed4=; b=ReBqDNABl15RKckfM9BOU60HSGFv4xZl+3fme5RFS6W4oY74Y5TooTXoGFVv8hUJZ7QV38 qnqIcYLCjjQhHa88bEuoS8VNH5YjVJVorncG2Za6JHTPUb7mQc+JvjFtHDVKV4Z56N9Q3a NQ3CK/dvTzn41QBKmVkw9dQXfSXKrtk= Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-417-qUThfUr_Md-jkJPlvl8lbQ-1; Tue, 25 Jun 2024 19:12:47 -0400 X-MC-Unique: qUThfUr_Md-jkJPlvl8lbQ-1 Received: from mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.15]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 699D6195608B; Tue, 25 Jun 2024 23:12:45 +0000 (UTC) Received: from localhost (unknown [10.42.28.182]) by mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id E2FE11956087; Tue, 25 Jun 2024 23:12:43 +0000 (UTC) From: Jonathan Wakely To: libstdc++@gcc.gnu.org, gcc-patches@gcc.gnu.org Subject: [PATCH] libstdc++: Add script to update docs for a new release branch Date: Wed, 26 Jun 2024 00:02:32 +0100 Message-ID: <20240625231242.2631700-1-jwakely@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.15 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_SHORT, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H4, RCVD_IN_MSPIKE_WL, RCVD_IN_SBL_CSS, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+incoming=patchwork.ozlabs.org@gcc.gnu.org This script automates some updates that should be made when branching from trunk. Putting them in a script makes it much easier and means I won't forget what should be done. Any suggestions for doing this differently? Anything I've forgotten that should be added here? We could add an entry to the lists of versions at https://gcc.gnu.org/onlinedocs/libstdc++/manual/abi.html#abi.versioning.goals but that should really be done when bumping the libtool version, not when branching from trunk. -- >8 -- This should be run on a release branch after branching from trunk. Various links and references to trunk in the docs will be updated to refer to the new release branch. libstdc++-v3/ChangeLog: * scripts/update_release_branch.sh: New file. --- libstdc++-v3/scripts/update_release_branch.sh | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100755 libstdc++-v3/scripts/update_release_branch.sh diff --git a/libstdc++-v3/scripts/update_release_branch.sh b/libstdc++-v3/scripts/update_release_branch.sh new file mode 100755 index 00000000000..f8109ed0ba3 --- /dev/null +++ b/libstdc++-v3/scripts/update_release_branch.sh @@ -0,0 +1,14 @@ +#!/bin/bash + +# This should be run on a release branch after branching from trunk. +# Various links and references to trunk in the docs will be updated to +# refer to the new release branch. + +# The major version of the new release branch. +major=$1 +(($major)) || { echo "$0: Integer argument expected" >& 2 ; exit 1; } + +# This assumes GNU sed +sed -i "s@^mainline GCC, not in any particular major.\$@the GCC ${major} series.@" doc/xml/manual/status_cxx*.xml +sed -i 's@https://gcc.gnu.org/cgit/gcc/tree/libstdc++-v3/testsuite/[^"]\+@&?h=releases%2Fgcc-'${major}@ doc/xml/manual/allocator.xml doc/xml/manual/mt_allocator.xml +sed -i "s@https://gcc.gnu.org/onlinedocs/gcc/Invoking-GCC.html@https://gcc.gnu.org/onlinedocs/gcc-${major}.1.0/gcc/Invoking-GCC.html@" doc/xml/manual/using.xml