summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2010-08-16 01:15:34 -0700
committerZac Medico <zmedico@gentoo.org>2010-08-16 01:15:34 -0700
commit5592d3460edc20b7be72d1b4644a2be22ab5f50d (patch)
tree9a502267d715d96a3bae8230b925ab790ed587d4 /doc
parentfa5171546bca258ff8bf1c47963f095cf7fe4d24 (diff)
downloadportage-5592d3460edc20b7be72d1b4644a2be22ab5f50d.tar.gz
portage-5592d3460edc20b7be72d1b4644a2be22ab5f50d.tar.bz2
portage-5592d3460edc20b7be72d1b4644a2be22ab5f50d.zip
Bug #273646 - Copy PMS section 12.1.2 EAPI 4 docs for REPLACING_VERSIONS
and REPLACED_BY_VERSION variables.
Diffstat (limited to 'doc')
-rw-r--r--doc/package/ebuild/eapi/4.docbook18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/package/ebuild/eapi/4.docbook b/doc/package/ebuild/eapi/4.docbook
index eda4dc37d..44e005f45 100644
--- a/doc/package/ebuild/eapi/4.docbook
+++ b/doc/package/ebuild/eapi/4.docbook
@@ -202,5 +202,23 @@ src_install() {
The AA and KV variables are no longer exported to the ebuild environment.
</para>
</section>
+ <section id='package-ebuild-eapi-4_pre1-variables-replaced-versions'>
+ <title>REPLACING_VERSIONS and REPLACED_BY_VERSION</title>
+ <para>
+ The REPLACING_VERSIONS variable
+ shall be defined in pkg_preinst and pkg_postinst. In addition, it may be
+ defined in pkg_pretend and pkg_setup, although ebuild authors should take care
+ to handle binary package creation and installation correctly when using it in
+ these phases.
+ </para>
+ <para>
+ REPLACING_VERSIONS is a list, not a single optional value, to handle
+ pathological cases such as installing foo-2:2 to replace foo-2:1 and foo-3:2.
+ </para>
+ <para>
+ The REPLACED_BY variable shall
+ be defined in pkg_prerm and pkg_postrm. It shall contain at most one value.
+ </para>
+ </section>
</section>
</section>