[gentoo-commits] proj/devmanual:master commit in: keywording/

["Sam James" <sam@gentoo.org>]

commit:     5ef0611901e3ef14e6473c960418985f6b6f7c61
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Wed Jan 12 04:36:03 2022 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Sat Jan 22 21:34:56 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=5ef06119

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 <AT> gentoo.org>
Closes: https://github.com/gentoo/devmanual/pull/262
Signed-off-by: Sam James <sam <AT> gentoo.org>

 keywording/text.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/keywording/text.xml b/keywording/text.xml
index 1398ca7..732271f 100644
--- a/keywording/text.xml
+++ b/keywording/text.xml
@@ -138,6 +138,12 @@ which are not hard masked must <b>not</b> have a dependency upon hard masked
 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