From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-1784588-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (4096 bits))
	(No client certificate requested)
	by finch.gentoo.org (Postfix) with ESMTPS id 3962B158200
	for <garchives@archives.gentoo.org>; Mon, 15 Sep 2025 08:43:09 +0000 (UTC)
Received: from lists.gentoo.org (bobolink.gentoo.org [140.211.166.189])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange x25519)
	(No client certificate requested)
	(Authenticated sender: relay-lists.gentoo.org@gentoo.org)
	by smtp.gentoo.org (Postfix) with ESMTPSA id 22927340F31
	for <garchives@archives.gentoo.org>; Mon, 15 Sep 2025 08:43:09 +0000 (UTC)
Received: from bobolink.gentoo.org (localhost [127.0.0.1])
	by bobolink.gentoo.org (Postfix) with ESMTP id 4F98B110572;
	Mon, 15 Sep 2025 08:43:05 +0000 (UTC)
Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange x25519)
	(No client certificate requested)
	by bobolink.gentoo.org (Postfix) with ESMTPS id 431F3110573
	for <gentoo-commits@lists.gentoo.org>; Mon, 15 Sep 2025 08:43:05 +0000 (UTC)
Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
	(No client certificate requested)
	by smtp.gentoo.org (Postfix) with ESMTPS id ED6D3340EFA
	for <gentoo-commits@lists.gentoo.org>; Mon, 15 Sep 2025 08:43:04 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
	by oystercatcher.gentoo.org (Postfix) with ESMTP id 673C239DF
	for <gentoo-commits@lists.gentoo.org>; Mon, 15 Sep 2025 08:43:03 +0000 (UTC)
From: "Ulrich Müller" <ulm@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" <ulm@gentoo.org>
Message-ID: <1757925739.6c3308be9ca79098e8653b3602b5832520e82a8d.ulm@gentoo>
Subject: [gentoo-commits] proj/devmanual:master commit in: keywording/maintenance/, keywording/
X-VCS-Repository: proj/devmanual
X-VCS-Files: keywording/maintenance/text.xml keywording/text.xml
X-VCS-Directories: keywording/maintenance/ keywording/
X-VCS-Committer: ulm
X-VCS-Committer-Name: Ulrich Müller
X-VCS-Revision: 6c3308be9ca79098e8653b3602b5832520e82a8d
X-VCS-Branch: master
Date: Mon, 15 Sep 2025 08:43:03 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
X-Archives-Salt: d5345689-28fd-4f23-b223-01d8732c9ad8
X-Archives-Hash: 56dba11609228b43d2bf05f68c82e9e7

commit:     6c3308be9ca79098e8653b3602b5832520e82a8d
Author:     Arthur Zamarin <arthurzam <AT> gentoo <DOT> org>
AuthorDate: Sat Sep  6 07:31:08 2025 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Sep 15 08:42:19 2025 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=6c3308be

keywording/maintenance: add section for destabilizing an arch

Signed-off-by: Arthur Zamarin <arthurzam <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 keywording/maintenance/text.xml | 54 +++++++++++++++++++++++++++++++++++++++++
 keywording/text.xml             |  1 +
 2 files changed, 55 insertions(+)

diff --git a/keywording/maintenance/text.xml b/keywording/maintenance/text.xml
new file mode 100644
index 0000000..228f070
--- /dev/null
+++ b/keywording/maintenance/text.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<devbook self="keywording/maintenance/">
+<chapter>
+<title>Arch and profile maintenance</title>
+
+<section>
+<title>Moving an arch from arch to ~arch</title>
+<body>
+
+<p>
+When demoting an entire architecture from stable (<c>arch</c>) to testing
+(<c>~arch</c>), perform the following:
+</p>
+
+<ol>
+  <li>
+    Prepare and publish a Gentoo news item announcing the architecture
+    destabilization, following the process described in
+    <uri link="::general-concepts/news/"/> (per
+        <uri link="https://www.gentoo.org/glep/glep-0042.html">GLEP 42</uri>).
+  </li>
+  <li>
+    Update the profile to accept both stable and testing keywords by setting
+    <c>ACCEPT_KEYWORDS="${ARCH} ~${ARCH}"</c> in the appropriate
+    <c>profiles/arch/${ARCH}/...</c> file(s).
+  </li>
+  <li>
+    Remove the architecture from all open stabilization bugs using the script
+    at
+    <uri>https://gitweb.gentoo.org/proj/pkgcore/pkgcore.git/tree/examples/destable_arch_bugs.py</uri>.
+  </li>
+  <li>
+    Convert all ebuild keywords for the architecture to testing:
+    <c>qkeyword --all "${ARCH}" | cut -f1 -d" " | xargs -n 250 qatom
+    -F "%{CATEGORY}/%{PN}/%{PF}.ebuild" | xargs ekeyword "~${ARCH}"</c>
+    (<c>qkeyword</c> and <c>qatom</c> are tools from
+    <c>app-portage/portage-utils</c>, while <c>ekeyword</c> is provided by
+    <c>app-portage/gentoolkit</c>).
+  </li>
+  <li>
+    Update any eclasses that define shared <c>KEYWORDS</c> variables. Currently,
+    this includes <c>acct-group.eclass</c> and <c>acct-user.eclass</c>.
+  </li>
+  <li>
+    Update the architecture status in the template files within the
+    <uri link="https://gitweb.gentoo.org/fork/bugzilla.git/">bugzilla</uri>
+    repository as needed.
+  </li>
+</ol>
+
+</body>
+</section>
+</chapter>
+</devbook>

diff --git a/keywording/text.xml b/keywording/text.xml
index 490b3fb..6ed75c6 100644
--- a/keywording/text.xml
+++ b/keywording/text.xml
@@ -18,4 +18,5 @@ Refer to the subpages for details on policy, procedures, and maintenance.
 
 <include href="concepts/"/>
 <include href="workflow/"/>
+<include href="maintenance/"/>
 </devbook>