[gentoo-portage-dev] [PATCH 3/3] Document targetroot useflag in ebuild(5)

[Dennis Schridde]

---
 man/ebuild.5 | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/man/ebuild.5 b/man/ebuild.5
index 2652f89..0d5e448 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
-- 
1.7.12