1 |
commit: 86b022ce2a4fdd7b8477320d46088cb05e62e0f5 |
2 |
Author: James Le Cuirot <chewi <AT> gentoo <DOT> org> |
3 |
AuthorDate: Mon Apr 2 21:36:07 2018 +0000 |
4 |
Commit: Zac Medico <zmedico <AT> gentoo <DOT> org> |
5 |
CommitDate: Tue May 1 08:28:44 2018 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=86b022ce |
7 |
|
8 |
man: emerge: Describe the SYSROOT environment variable for EAPI 7 |
9 |
|
10 |
This deprecates the --root-deps option and the PORTAGE_CONFIGROOT |
11 |
variable. |
12 |
|
13 |
man/emerge.1 | 38 +++++++++++++++++++++++++++++--------- |
14 |
1 file changed, 29 insertions(+), 9 deletions(-) |
15 |
|
16 |
diff --git a/man/emerge.1 b/man/emerge.1 |
17 |
index a3c8dd7cd..f53ba92f5 100644 |
18 |
--- a/man/emerge.1 |
19 |
+++ b/man/emerge.1 |
20 |
@@ -911,6 +911,9 @@ necessary. |
21 |
.BR \-\-root=DIR |
22 |
Set the \fBROOT\fR environment variable. |
23 |
.TP |
24 |
+.BR \-\-sysroot=DIR |
25 |
+Set the \fBSYSROOT\fR environment variable. |
26 |
+.TP |
27 |
.BR \-\-root\-deps[=rdeps] |
28 |
If no argument is given then build\-time dependencies of packages for |
29 |
\fBROOT\fR are installed to \fBROOT\fR instead of /. |
30 |
@@ -919,12 +922,16 @@ of packages for \fBROOT\fR. |
31 |
This option is only meaningful when used together with \fBROOT\fR and it should |
32 |
not be enabled under normal circumstances! |
33 |
|
34 |
-Does not affect EAPIs that support \fBHDEPEND\fR. |
35 |
-Experimental \fBEAPI 5-hdepend\fR provides \fBHDEPEND\fR as a new |
36 |
-means to adjust installation into "\fI/\fR" and \fBROOT\fR. |
37 |
-If ebuilds using EAPIs which \fIdo not\fR support \fBHDEPEND\fR are built in |
38 |
-the same \fBemerge\fR run as those using EAPIs which \fIdo\fR support |
39 |
-\fBHDEPEND\fR, this option affects only the former. |
40 |
+Does not affect EAPIs that support \fBBDEPEND\fR or \fBHDEPEND\fR. |
41 |
+\fBEAPI 7\fR introduces \fBBDEPEND\fR and experimental |
42 |
+\fBEAPI 5-hdepend\fR features \fBHDEPEND\fR as a means to adjust |
43 |
+installation into / and \fBROOT\fR. Use the \fBSYSROOT\fR environment |
44 |
+variable to control where \fBDEPEND\fR is installed to under |
45 |
+\fBEAPI 7\fR. |
46 |
+ |
47 |
+When ebuilds with different EAPIs feature in the same emerge run, the |
48 |
+appropriate behaviour for each EAPI is applied independently to each |
49 |
+ebuild. |
50 |
.TP |
51 |
.BR "\-\-search\-index < y | n >" |
52 |
Enable or disable indexed search for search actions. This option is |
53 |
@@ -1090,8 +1097,19 @@ Defaults to the prefix where portage is currently installed. |
54 |
.TP |
55 |
\fBROOT\fR = \fI[path]\fR |
56 |
Use \fBROOT\fR to specify the target root filesystem to be used for |
57 |
-merging packages or ebuilds. This variable can be set via the \fB\-\-root\fR |
58 |
-option or in \fBmake.conf\fR(5) (the command line overrides other settings). |
59 |
+merging the requested packages or ebuilds and their runtime |
60 |
+dependencies. This variable can be set via the \fB\-\-root\fR option |
61 |
+or in \fBmake.conf\fR(5) (the command line overrides other settings). |
62 |
+.br |
63 |
+Defaults to /. |
64 |
+.TP |
65 |
+\fBSYSROOT\fR = \fI[path]\fR |
66 |
+Use \fBSYSROOT\fR to specify the target root filesystem to be used for |
67 |
+merging the build dependencies satisfied by \fBDEPEND\fR. This |
68 |
+variable can be set via the \fB\-\-sysroot\fR option or in |
69 |
+\fBmake.conf\fR(5) (the command line overrides other settings). The |
70 |
+value must either be / or equal to \fBROOT\fR. When cross-compiling, |
71 |
+only the latter is valid. |
72 |
.br |
73 |
Defaults to /. |
74 |
.TP |
75 |
@@ -1099,7 +1117,9 @@ Defaults to /. |
76 |
Use \fBPORTAGE_CONFIGROOT\fR to specify the location for various portage |
77 |
configuration files |
78 |
(see \fBFILES\fR for a detailed list of configuration files). This variable |
79 |
-can be set via the \fB\-\-config\-root\fR option. |
80 |
+can be set via the \fB\-\-config\-root\fR option. However, it is now |
81 |
+superseded by the \fBSYSROOT\fR variable and can only be given if its |
82 |
+value matches \fBSYSROOT\fR or if \fBROOT=/\fR. |
83 |
.br |
84 |
Defaults to /. |
85 |
.SH "OUTPUT" |