From 4159f7a596e1d0416410f5c22db6fa23df7575e8 Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Fri, 5 Oct 2007 21:34:27 +0000 Subject: [PATCH] Generalize the first paragraph of the MASKED PACKAGES section and document binary package CHOST masking. (trunk r7958) svn path=/main/branches/2.1.2/; revision=7970 --- man/emerge.1 | 13 +++++++++---- 1 file 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 -- 2.26.2