summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2010-08-16 01:36:39 -0700
committerZac Medico <zmedico@gentoo.org>2010-08-16 01:36:39 -0700
commit886fd42ab4acd3a3ab8014d7846835ed00532a71 (patch)
tree13f3563542f4ba0447c302d30005e37845927f08
parent5592d3460edc20b7be72d1b4644a2be22ab5f50d (diff)
downloadportage-886fd42ab4acd3a3ab8014d7846835ed00532a71.tar.gz
portage-886fd42ab4acd3a3ab8014d7846835ed00532a71.tar.bz2
portage-886fd42ab4acd3a3ab8014d7846835ed00532a71.zip
Bug #273648 - Document restriction of S to WORKDIR fallback in EAPI 4.
-rw-r--r--doc/package/ebuild/eapi/4.docbook13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/package/ebuild/eapi/4.docbook b/doc/package/ebuild/eapi/4.docbook
index 44e005f45..a96910e83 100644
--- a/doc/package/ebuild/eapi/4.docbook
+++ b/doc/package/ebuild/eapi/4.docbook
@@ -193,6 +193,19 @@ src_install() {
}
</programlisting>
</section>
+ <section id='package-ebuild-eapi-4_pre1-phases-s-workdir-fallback'>
+ <title>S to WORKDIR fallback restricted</title>
+ <para>
+ For any of the src_* phases that executes after src_unpack,
+ it is invalid for the S variable to refer to a non-existent
+ directory. However, these src_* phases are exempt from this
+ requirement if none of the prior src_* phases are defined by the
+ ebuild. When a src_* phase is exempt from this requirement, if the
+ S variable does not refer to an existing directory, the
+ WORKDIR directory will be used instead of S as the initial working
+ directory.
+ </para>
+ </section>
</section>
<section id='package-ebuild-eapi-4_pre1-variables'>
<title>Variables</title>