1 |
Author: zmedico |
2 |
Date: 2008-09-04 19:22:59 +0000 (Thu, 04 Sep 2008) |
3 |
New Revision: 11490 |
4 |
|
5 |
Modified: |
6 |
main/trunk/doc/package/ebuild/eapi/2.docbook |
7 |
Log: |
8 |
Document EAPI 2 blocker atom extensions (not yet implemented). |
9 |
|
10 |
|
11 |
Modified: main/trunk/doc/package/ebuild/eapi/2.docbook |
12 |
=================================================================== |
13 |
--- main/trunk/doc/package/ebuild/eapi/2.docbook 2008-09-04 18:50:58 UTC (rev 11489) |
14 |
+++ main/trunk/doc/package/ebuild/eapi/2.docbook 2008-09-04 19:22:59 UTC (rev 11490) |
15 |
@@ -309,6 +309,34 @@ |
16 |
</section> |
17 |
<section id='package-ebuild-eapi-2-draft-dependencies'> |
18 |
<title>Dependencies</title> |
19 |
+ <section id='package-ebuild-eapi-2-draft-dependencies-blocker-atoms'> |
20 |
+ <title>Blocker Atoms</title> |
21 |
+ <section id='package-ebuild-eapi-2-draft-dependencies-blocker-atoms-new-meaning'> |
22 |
+ <title>New Meaning for Old Syntax</title> |
23 |
+ <para> |
24 |
+ Blocker atoms which use the previously existing !atom syntax now have |
25 |
+ a slightly different meaning. These blocker atoms indicate that |
26 |
+ conflicting packages may be temporarily installed simultaneously. When |
27 |
+ temporary simultaneous installation of conflicting packages occurs, the |
28 |
+ installation of a newer package may overwrite any colliding files that |
29 |
+ belong to an older package which is explicitly blocked. When such file |
30 |
+ collisions occur, the colliding files cease to belong to the older |
31 |
+ package, and they remain installed after the older package is |
32 |
+ eventually uninstalled. The older package is uninstalled only after |
33 |
+ any newer blocking packages have been merged on top of it. |
34 |
+ </para> |
35 |
+ </section> |
36 |
+ <section id='package-ebuild-eapi-2-draft-dependencies-blocker-atoms-new-syntax'> |
37 |
+ <title>New !!atom Syntax</title> |
38 |
+ <para> |
39 |
+ A new !!atom syntax is now supported, for use in special cases for which |
40 |
+ temporary simultaneous installation of blocking packages should not be |
41 |
+ allowed. If a given package happens to be blocked my a mixture of atoms |
42 |
+ consisting of both the !atom and !!atom syntaxes, the !!atom syntax takes |
43 |
+ precedence over the !atom syntax. |
44 |
+ </para> |
45 |
+ </section> |
46 |
+ </section> |
47 |
<section id='package-ebuild-eapi-2-draft-dependencies-use'> |
48 |
<title>USE Dependencies</title> |
49 |
<section id='package-ebuild-eapi-2-draft-dependencies-use-unconditional'> |