From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 59BBA1382C5 for ; Wed, 7 Apr 2021 17:35:37 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 8407AE0A44; Wed, 7 Apr 2021 17:35:34 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 62DDEE0A44 for ; Wed, 7 Apr 2021 17:35:34 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 84523335CC8 for ; Wed, 7 Apr 2021 17:35:32 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 12096702 for ; Wed, 7 Apr 2021 17:35:29 +0000 (UTC) From: "Ulrich Müller" 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" Message-ID: <1617816913.5415582aaa5845c3b71501f92ad8e547bd1c0c30.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: keywording/ X-VCS-Repository: proj/devmanual X-VCS-Files: keywording/text.xml X-VCS-Directories: keywording/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 5415582aaa5845c3b71501f92ad8e547bd1c0c30 X-VCS-Branch: master Date: Wed, 7 Apr 2021 17:35:29 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: ad7fe7e7-dacb-498d-be50-578111984363 X-Archives-Hash: ede66a94a34c2eddaa3cfa974f0d7d72 commit: 5415582aaa5845c3b71501f92ad8e547bd1c0c30 Author: Sam James gentoo org> AuthorDate: Sun Mar 21 08:58:33 2021 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Wed Apr 7 17:35:13 2021 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=5415582a keywording: expound on NATTkA importance and HOWTO Signed-off-by: Sam James gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> keywording/text.xml | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/keywording/text.xml b/keywording/text.xml index 9e7177e..f57e18a 100644 --- a/keywording/text.xml +++ b/keywording/text.xml @@ -260,6 +260,41 @@ That way, teams can remove themselves from the list when they are done, giving a clear indication of which teams still remain to stabilize a package.

+

+It is strongly + +recommended that NATTkA be used to file keywording or +stabilization bugs to ensure that arches are not accidentally forgot about; +the automation removes an often error-prone step in the arch-testing process. +Ask in #gentoo-dev or on the gentoo-dev mailing list if you need help. +

+ +

+NATTkA will set the sanity-check field on Bugzilla to either +- or + depending on whether the package list results in a +consistent dependency graph. You may need to add more packages or adjust the +archs listed for each package based on the output the bot posts as a comment +on the bug. Please note that arch teams may not process or notice bugs with a +blank or - sanity-check, so please fix this if it occurs or ask for +help to do so. +

+ + +Note that sometimes NATTkA may do nothing if it has concluded the package +list is complete. You may wish to run nattka sanity-check BUG where +BUG is the bug number you're having an issue with in order to debug the +issue to receive verbose output. + + +

+You may wish to read NATTkA's + +documentation for help on package list syntax or other information about +the tool. The documentation details syntax which can be used, such as * +to represent 'all previously stable arches', or '^' to copy the arches from the +line(s) above. +

+

For an ebuild to move to stable, the following guidelines must be met (see GLEP 40