From: Dennis Schridde <devurandom@gmx.net>
Date: Tue, 25 Sep 2012 13:58:24 +0000 (+0200)
Subject: Document targetroot useflag in ebuild(5)
X-Git-Tag: v2.2.0_alpha133~13
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=25b0c4545c9a3e8b80347bd458d80b4add330ef6;p=portage.git

Document targetroot useflag in ebuild(5)
---

diff --git a/man/ebuild.5 b/man/ebuild.5
index 2652f89c1..0d5e4484d 100644
--- a/man/ebuild.5
+++ b/man/ebuild.5
@@ -349,6 +349,15 @@ Without it, \fBemerge\fR defaults to install only runtime dependencies (i.e.
 .PP
 See section \fBVARIABLES\fR for more information about the \fBDEPEND\fR,
 \fBRDEPEND\fR and \fBHDEPEND\fR variables.
+.TP
+.B The targetroot USE flag
+For EAPIs that support the "\fItargetroot\fR" USE flag, that flag is
+automatically enabled by the package manager if \fIhost\fR and \fItarget\fR
+system are not the same, i.e. if the \fBROOT\fR is not "\fI/\fR".
+This is necessary where the package to be built needs an executable copy of
+itself during the build process.
+A known example is dev-lang/python, which needs to run a Python interpreter
+during compilation.
 
 .SH "VARIABLES"
 .TP