summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2007-10-05 20:05:17 +0000
committerZac Medico <zmedico@gentoo.org>2007-10-05 20:05:17 +0000
commit5832ec9302b9787668c554264bdba3ae843f4f82 (patch)
tree30351ef14b9b3ddad8838294b80b6692fbfd3e9d
parent41586dcf1bc6b95cb1280eeb505dfe4d0558a142 (diff)
downloadportage-5832ec9302b9787668c554264bdba3ae843f4f82.tar.gz
portage-5832ec9302b9787668c554264bdba3ae843f4f82.tar.bz2
portage-5832ec9302b9787668c554264bdba3ae843f4f82.zip
Generalize the first paragraph of the MASKED PACKAGES section
and document binary package CHOST masking. svn path=/main/trunk/; revision=7958
-rw-r--r--man/emerge.113
1 files changed, 9 insertions, 4 deletions
diff --git a/man/emerge.1 b/man/emerge.1
index 2439618c6..80e903e45 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -529,12 +529,11 @@ and bugs resulting from misusing masked packages drains Gentoo
developer time. Please be sure you are capable of handling any problems
that may ensue.\fR
.LP
-Masks in \fBportage\fR provide three primary functions: they allow a
+Masks in \fBportage\fR have many uses: they allow a
testing period where the packages can be used in live machines; they
prevent the use of a package when it will fail; and they mask existing
-packages that are broken or could pose a security risk. Masking can be
-done by two methods: \fBpackage.mask\fR and \fBKEYWORDS\fR. Read below
-to find out how to unmask in either case. Also note that if you give
+packages that are broken or could pose a security risk. Read below
+to find out how to unmask in various cases. Also note that if you give
\fBemerge\fR an ebuild, then all forms of masking will be ignored and
\fBemerge\fR will attempt to emerge the package.
.TP
@@ -543,6 +542,12 @@ The \fBpackage.mask\fR file primarily blocks the use of packages that cause
problems or are known to have issues on different systems. It resides in
\fI/usr/portage/profiles\fR.
.TP
+.BR CHOST
+The \CHOST\fR variable in \fBmake.conf\fR(5) is used to mask binary packages
+that have been built with a different \CHOST\fR setting. The only
+way to unmask such a binary package is to change the \CHOST\fR environment
+variable so that it exactly matches that of the binary package.
+.TP
.BR EAPI
The \fBEAPI\fR variable in an \fBebuild\fR(5) file is used to mask packages
that are not supported by the current version of portage. Packages masked by