diff options
author | Sam James <sam@gentoo.org> | 2022-01-12 04:36:03 +0000 |
---|---|---|
committer | Sam James <sam@gentoo.org> | 2022-01-22 21:34:56 +0000 |
commit | 5ef0611901e3ef14e6473c960418985f6b6f7c61 (patch) | |
tree | a58550e0c36af39cefa41dbcb3f0248d51a1e088 /keywording | |
parent | keywording: add note about `repoman commit --straight-to-stable` (diff) | |
download | devmanual-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.xml | 6 |
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 |