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>
