diff options
author | Alexandre Rostovtsev <tetromino@gentoo.org> | 2012-12-10 09:20:00 -0500 |
---|---|---|
committer | Markos Chandras <hwoarang@gentoo.org> | 2013-01-19 10:20:10 +0000 |
commit | 9c3bba54f96fc96c0f3e4929b3bc84a3d84d0aa9 (patch) | |
tree | 8fea3db5f821c50c2236b5062637819274a5b3c6 /general-concepts/dependencies/text.xml | |
parent | document handling of -Werror wrt #415979 (diff) | |
download | devmanual-9c3bba54f96fc96c0f3e4929b3bc84a3d84d0aa9.tar.gz devmanual-9c3bba54f96fc96c0f3e4929b3bc84a3d84d0aa9.tar.bz2 devmanual-9c3bba54f96fc96c0f3e4929b3bc84a3d84d0aa9.zip |
eapi: Improve sub-slot and slot operator documentation, bug #446740
Add sub-slots to the Slotting chapter. Update the slot name sections
to match current portage versions (as noted by Arfrever). Add slot
operators to the Dependencies chapter, and describe sub-slot
dependencies (as suggested by Arfrever). Rephrase the slot operator
documentation in the EAPI Usage chapter to be a bit more readable
and a bit less PMS-like, explain sub-slot dependencies in more detail,
and add brief examples.
Diffstat (limited to 'general-concepts/dependencies/text.xml')
-rw-r--r-- | general-concepts/dependencies/text.xml | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index ba4a46c..ce25fa7 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -267,6 +267,45 @@ DEPEND="qt3? ( x11-libs/qt:3 ) gtk? ( x11-libs/gtk+:2 ) </codesample> +<subsection> +<title>Slot Operators</title> +<body> + +<p> +In <c>EAPI="5"</c> and higher, you can use slot operators appended to the package +name to declare whether or not your package should be rebuilt after the versions +satisfying its runtime dependencies are updated to versions with a different slot +or <uri link="::general-concepts/slotting#Sub-Slots">sub-slot</uri>: +</p> + +<ul> + <li><c>:=</c> means that any slot is acceptable, and that your package should be + rebuilt if the version best matching the runtime dependency is updated to a + version with a different slot or subslot;</li> + <li><c>:*</c> means that any slot is acceptable, and explicitly declares that + changes in the slot or sub-slot can be ignored;</li> + <li><c>:SLOT=</c> means that only the 'SLOT' slot is acceptable, and that your + package should be rebuilt if the version matching the runtime dependency is + updated to another version with this slot but with a different subslot;</li> + <li><c>:SLOT</c> means that only the 'SLOT' slot is acceptable, and that changes + in the sub-slot can be ignored (like in previous EAPIs).</li> + <li><c>:SLOT/SUBSLOT</c> means a dependency on a specific slot and sub-slot pair, + which can be useful for packages installing pre-built binaries that require a + library with a particular soname version corresponding to the sub-slot.</li> +</ul> + +<p> +For example: +</p> + +<codesample lang="ebuild"> +RDEPEND="media-libs/cogl:1.0= + gnutls? ( >=net-libs/gnutls-2.8:= )" +</codesample> + +</body> +</subsection> + </body> </section> |