summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFabian Groffen <grobian@gentoo.org>2009-12-10 12:41:41 +0000
committerFabian Groffen <grobian@gentoo.org>2009-12-10 12:41:41 +0000
commit75ea9fecaee81c0e37211272a19a857724294ad8 (patch)
tree710397a2eb3e688f462e9d1c18359aeedfb6881b
parentc7fe3bd3909f85512d9476d92c1ba5cf1fd14082 (diff)
downloadportage-75ea9fecaee81c0e37211272a19a857724294ad8.tar.gz
portage-75ea9fecaee81c0e37211272a19a857724294ad8.tar.bz2
portage-75ea9fecaee81c0e37211272a19a857724294ad8.zip
fix definition regarding slashes for EPREFIX, D, ED and EROOT
svn path=/main/trunk/; revision=15026
-rw-r--r--man/ebuild.523
1 files changed, 14 insertions, 9 deletions
diff --git a/man/ebuild.5 b/man/ebuild.5
index 16d6138c1..a229bf90a 100644
--- a/man/ebuild.5
+++ b/man/ebuild.5
@@ -105,8 +105,9 @@ location in the portage tree. Do not modify this variable.
.B EPREFIX
Contains the offset that this Portage was configured for during
installation. The offset is sometimes necessary in an ebuild or eclass,
-and is available in such cases as ${EPREFIX}. Do not modify this
-variable.
+and is available in such cases as ${EPREFIX}. EPREFIX does not contain
+a trailing slash, therefore an absent offset is represented by the empty
+string. Do not modify this variable.
.TP
\fBS\fR = \fI"${WORKDIR}/${P}"\fR
Contains the path to the temporary \fIbuild directory\fR. This variable
@@ -118,13 +119,15 @@ be modified to match the extraction directory of a tarball for the package.
Contains the path to a \fItemporary directory\fR. You may use this for
whatever you like.
.TP
-\fBD\fR = \fI"${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image"\fR
+\fBD\fR = \fI"${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image/"\fR
Contains the path to the temporary \fIinstall directory\fR. Every write
operation that does not involve the helper tools and functions (found below)
-should be prefixed with ${D}. Do not modify this variable.
+should be prefixed with ${D}. Often the offset prefix needs to be taken
+into account here, for which the variable ${ED} is provided (see below).
+Do not modify this variable.
.TP
-\fBED\fT = \fI"${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image/${EPREFIX}"\fR
-Contains the path "${D}${EPREFIX}" for convenience purposes. Do not
+\fBED\fT = \fI"${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image/${EPREFIX}/"\fR
+Contains the path "${D%/}${EPREFIX}/" for convenience purposes. Do not
modify this variable.
.TP
.B PORTAGE_LOG_FILE
@@ -134,10 +137,12 @@ Contains the path of the build log. If \fBPORT_LOGDIR\fR variable is unset then
\fBROOT\fR = \fI"/"\fR
Contains the path that portage should use as the root of the live filesystem.
When packages wish to make changes to the live filesystem, they should do so in
-the tree prefixed by ${ROOT}. Do not modify this variable.
+the tree prefixed by ${ROOT}. Often the offset prefix needs to be taken
+into account here, for which the variable ${EROOT} is provided (see
+below). Do not modify this variable.
.TP
-\fBEROOT\fR = \fI"${ROOT}${EPREFIX%/}"\fR
-Contains "${ROOT}${EPREFIX%/}" for convenience purposes. Do not modify
+\fBEROOT\fR = \fI"${ROOT%/}${EPREFIX}/"\fR
+Contains "${ROOT%/}${EPREFIX}/" for convenience purposes. Do not modify
this variable.
.TP
\fBDESCRIPTION\fR = \fI"A happy little package"\fR