diff options
| author |   Zac Medico <zmedico@gentoo.org> | 2008-09-20 08:17:15 +0000 |
|---|---|---|
| committer | Zac Medico <zmedico@gentoo.org> | 2008-09-20 08:17:15 +0000 |
| commit | 6ea674b66400655cec2cd222cc5cc2121b4ffb2f (patch) | |
| tree | f9b10e7240ac26a212a8a8261724fe3c59eb0352 /doc/package | |
| parent | Implement SRC_URI arrows for EAPI 2. The portdbapi.getfetchlist() method (diff) | |
| download | portage-6ea674b66400655cec2cd222cc5cc2121b4ffb2f.tar.gz portage-6ea674b66400655cec2cd222cc5cc2121b4ffb2f.tar.bz2 portage-6ea674b66400655cec2cd222cc5cc2121b4ffb2f.zip | |
Add a "EAPI 2_pre3" section to show what's changed.
svn path=/main/trunk/; revision=11523
Diffstat (limited to 'doc/package')
| -rw-r--r-- | doc/package/ebuild/eapi/2.docbook | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/doc/package/ebuild/eapi/2.docbook b/doc/package/ebuild/eapi/2.docbook index ceec15ccf..ef1038b40 100644 --- a/doc/package/ebuild/eapi/2.docbook +++ b/doc/package/ebuild/eapi/2.docbook @@ -216,6 +216,67 @@ src_compile() { </section> </section> </section> +<section id='package-ebuild-eapi-2-pre3'> + <title>EAPI 2_pre3</title> + <section id='package-ebuild-eapi-2-pre3-metadata'> + <title>Metadata</title> + <section id='package-ebuild-eapi-2-pre3-metadata-dependencies'> + <title>Dependencies</title> + <section id='package-ebuild-eapi-2-pre3-metadata-dependencies-blocker-atoms'> + <title>Blocker Atoms</title> + <section id='package-ebuild-eapi-2-pre3-metadata-dependencies-blocker-atoms-new-meaning'> + <title>New Meaning for Old Syntax</title> + <para> + Blocker atoms which use the previously existing !atom syntax now have + a slightly different meaning. These blocker atoms indicate that + conflicting packages may be temporarily installed simultaneously. When + temporary simultaneous installation of conflicting packages occurs, the + installation of a newer package may overwrite any colliding files that + belong to an older package which is explicitly blocked. When such file + collisions occur, the colliding files cease to belong to the older + package, and they remain installed after the older package is + eventually uninstalled. The older package is uninstalled only after + any newer blocking packages have been merged on top of it. + </para> + </section> + <section id='package-ebuild-eapi-2-pre3-metadata-dependencies-blocker-atoms-new-syntax'> + <title>New !!atom Syntax</title> + <para> + A new !!atom syntax is now supported, for use in special cases for which + temporary simultaneous installation of conflicting packages should not be + allowed. If a given package happens to be blocked my a mixture of atoms + consisting of both the !atom and !!atom syntaxes, the !!atom syntax takes + precedence over the !atom syntax. + </para> + </section> + </section> + </section> + <section id='package-ebuild-eapi-2-pre3-metadata-src-uri'> + <title>SRC_URI</title> + <section id='package-ebuild-eapi-2-pre3-metadata-src-uri-output-file-name-customization'> + <title>Customization of Output File Names</title> + <para> + A new syntax is supported which allows customization of the output + file name for a given URI. In order to customize the output file + name, a given URI should be followed by a "->" operator which, + in turn, should be followed by the desired output file name. As + usual, all tokens, including the operator and output file name, + should be separated by whitespace. + </para> + </section> + </section> + </section> + <section id='package-ebuild-eapi-2-pre3-phases'> + <title>Phases</title> + <section id='package-ebuild-eapi-2-pre3-phases-src-prepare'> + <title>New src_prepare Phase Function</title> + <para> + A new src_prepare function is called after the src_unpack + function, with cwd initially set to $S. + </para> + </section> + </section> +</section> <section id='package-ebuild-eapi-2-draft'> <title>EAPI 2 Draft</title> <section id='package-ebuild-eapi-2-draft-helpers'> |