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