aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2022-01-12 04:36:03 +0000
committerSam James <sam@gentoo.org>2022-01-22 21:34:56 +0000
commit5ef0611901e3ef14e6473c960418985f6b6f7c61 (patch)
treea58550e0c36af39cefa41dbcb3f0248d51a1e088 /keywording
parentkeywording: add note about `repoman commit --straight-to-stable` (diff)
downloaddevmanual-5ef0611901e3ef14e6473c960418985f6b6f7c61.tar.gz
devmanual-5ef0611901e3ef14e6473c960418985f6b6f7c61.tar.bz2
devmanual-5ef0611901e3ef14e6473c960418985f6b6f7c61.zip
keywording: mention filing bugs for package.mask entries
It's useful to have a bug filed for things masked for testing / due to breakages so that feedback can be gathered in one place / the relevant issue can be debugged. We've sometimes had things p.masked indefinitely for "testing" when it's not clear exactly what needs to be done left, or due to a "bug" which with few details cannot be reproduced some time later. Bug: https://bugs.gentoo.org/705394 Signed-off-by: Sam James <sam@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/262 Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'keywording')
-rw-r--r--keywording/text.xml6
1 files changed, 6 insertions, 0 deletions
diff --git a/keywording/text.xml b/keywording/text.xml
index 1398ca7..732271f 100644
--- a/keywording/text.xml
+++ b/keywording/text.xml
@@ -139,6 +139,12 @@ packages.
</p>
<p>
+It is good practice to file a bug for ebuilds listed in <c>package.mask</c> to
+allow feedback to be gathered in one location and to reduce the chance of
+forgetting about it. Mention the bug number in the mask message.
+</p>
+
+<p>
The only time it is acceptable for a user to see the <c>Possibly a DEPEND
problem</c> error message is if they have manually changed visibility levels for
a package (for example, through <c>/etc/portage/</c>) and have missed a