Gentoo Archives: gentoo-commits

From: "Zac Medico (zmedico)" <zmedico@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] portage r11490 - main/trunk/doc/package/ebuild/eapi
Date: Thu, 04 Sep 2008 19:46:20
Message-Id: E1KbKQ0-00067e-DW@stork.gentoo.org
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'>