From: Fabian Groffen <grobian@gentoo.org>
Date: Fri, 26 Aug 2011 19:36:10 +0000 (+0200)
Subject: man: document prefix behaviour for CONFIG_PROTECT, bug #378625
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=0fd596977391c67bcda11e2c81ad033e03dbc8f9;p=portage.git

man: document prefix behaviour for CONFIG_PROTECT, bug #378625
---

diff --git a/man/emerge.1 b/man/emerge.1
index fa5bed0d1..52f583a45 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -931,6 +931,12 @@ add this to /etc/make.conf:
 Tools such as dispatch\-conf, cfg\-update, and etc\-update are also available to
 aid in the merging of these files. They provide interactive merging and can
 auto\-merge trivial changes.
+.LP
+When an offset prefix (\fBEPREFIX\fR) is active, all paths in
+\fBCONFIG_PROTECT\fR and \fBCONFIG_PROTECT_MASK\fR are prefixed with the
+offset by Portage before they are considered.  Hence, these paths never
+contain the offset prefix, and the variables can be defined in
+offset-unaware locations, such as the profiles. 
 .SH "REPORTING BUGS"
 Please report any bugs you encounter through our website:
 .LP
diff --git a/man/make.conf.5 b/man/make.conf.5
index 76f32f718..6f5eec53d 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -138,6 +138,9 @@ Defaults to /lib/modules.
 All files and/or directories that are defined here will have "config file protection"
 enabled for them. See the \fBCONFIGURATION FILES\fR section
 of \fBemerge\fR(1) for more information.
+Note that if an offset prefix (\fBEPREFIX\fR) is activated, all paths defined
+in \fBCONFIG_PROTECT\fR are prefixed by Portage with the offset before
+they are used.
 .TP
 \fBCONFIG_PROTECT_MASK\fR = \fI[space delimited list of files and/or directories]\fR
 All files and/or directories that are defined here will have "config file protection"