Bug #276264 - Note that eclass-overrides may make it necessary to set

PORTAGE_RSYNC_EXTRA_OPTS="--exclude=/metadata/cache" in make.conf.

svn path=/main/trunk/; revision=13788

diff --git a/man/portage.5 b/man/portage.5
index 6f64af6bd03877210a8e30e9788327399a8d449f..3a70439956a4bcb4317592e05d2cb2a1d23281ef 100644 (file)
--- a/man/portage.5
+++ b/man/portage.5
@@ -556,7 +556,12 @@ performed by these tools
 are inherently \fBnot\fR \fIsite\-specific\fR. \fBWARNING:\fR Use of
 \fBrepos.conf\fR is generally not recommended since resulting changes in
 eclass inheritance (especially due to \fBeclass\-overrides\fR) may trigger
-performance issues under some circumstances (see \fBbug #124041\fR).
+performance issues under some circumstances (see \fBbug #124041\fR). When
+using \fBeclass\-overrides\fR, due to bug #276264, you must ensure that
+your portage tree does not contain a metadata/cache/. For example, you
+should set PORTAGE_RSYNC_EXTRA_OPTS="\-\-exclude=/metadata/cache" in
+make.conf in order to exclude the metadata/cache/ directory during
+\fBemerge\fR(1) \-\-sync operations.
 
 .I Example:
 .nf