From: Zac Medico <zmedico@gentoo.org>
Date: Mon, 22 Jul 2013 19:19:56 +0000 (-0700)
Subject: make.conf.5: note usersync reqs for bug #277970
X-Git-Tag: v2.2.0_alpha189~32
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=c81306a10124b3a4295528b34dd0393599cd5308;p=portage.git

make.conf.5: note usersync reqs for bug #277970
---

diff --git a/man/make.conf.5 b/man/make.conf.5
index adf32bd3a..fcab08dec 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -1,4 +1,4 @@
-.TH "MAKE.CONF" "5" "May 2013" "Portage VERSION" "Portage"
+.TH "MAKE.CONF" "5" "Jul 2013" "Portage VERSION" "Portage"
 .SH "NAME"
 make.conf \- custom settings for Portage
 .SH "SYNOPSIS"
@@ -583,7 +583,11 @@ Enable the sandbox in the compile phase, when running without root privs (\fIuse
 .TP
 .B usersync
 Drop privileges to the owner of \fBPORTDIR\fR for \fBemerge(1) --sync\fR
-operations.
+operations. Note that this feature assumes that all subdirectories of
+\fBPORTDIR\fR have the same ownership as \fBPORTDIR\fR itself. It is the
+user's responsibility to ensure correct ownership, since otherwise portage
+would have to waste time validating ownership for each and every sync
+operation.
 .TP
 .B webrsync-gpg
 Enable GPG verification when using \fIemerge\-webrsync\fR.