aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2015-05-03 19:21:27 +0200
committerUlrich Müller <ulm@gentoo.org>2015-05-07 00:06:49 +0200
commit6872325358f1b9f30273a50e22dabbbfc6ea8034 (patch)
tree56b9f878ccfa32f3dff6dbd33b3907814e05ec0f /profiles
parentMerge section about user-submitted ebuilds from Developer Handbook. (diff)
downloaddevmanual-6872325358f1b9f30273a50e22dabbbfc6ea8034.tar.gz
devmanual-6872325358f1b9f30273a50e22dabbbfc6ea8034.tar.bz2
devmanual-6872325358f1b9f30273a50e22dabbbfc6ea8034.zip
Merge package.mask policy from Developer Handbook.
This is taken from proj/en/devrel/handbook/hb-policy-ebuild.xml, section "QA policy", subsection "Masked packages". Permission to reuse the CC-BY-SA-1.0 work under CC-BY-SA-2.0 (or any later version) obtained from author plasmaroo per e-mail on 2015-04-16.
Diffstat (limited to 'profiles')
-rw-r--r--profiles/package.mask/text.xml11
1 files changed, 7 insertions, 4 deletions
diff --git a/profiles/package.mask/text.xml b/profiles/package.mask/text.xml
index ef57b28..6cef26d 100644
--- a/profiles/package.mask/text.xml
+++ b/profiles/package.mask/text.xml
@@ -5,10 +5,13 @@
<body>
<p>
-The <c>package.mask</c> file can be used to hard mask packages or certain versions
-of packages. This is often used when adding certain experimental (either in
-ebuild or upstream terms) packages to the tree. The format is described in
-<c>man portage</c>.
+The <c>package.mask</c> file can be used to hard mask packages or
+certain versions of packages that should not be merged by users.
+This is often used when adding certain experimental (either in ebuild
+or upstream terms) packages to the tree, or to prevent merging of
+packages that are broken or break something else. Every entry should
+have a comment detailing the specific reason for the mask. The format
+of the <c>package.mask</c> file is described in <c>man portage</c>.
</p>
<p>