diff options
author | Zac Medico <zmedico@gentoo.org> | 2010-08-16 00:10:56 -0700 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2010-08-16 00:10:56 -0700 |
commit | 13a1d0e6247bd227afd0c9738093e663a989ac30 (patch) | |
tree | e2a68ef423b8c7d4c242273c87c181cef6a7aa81 | |
parent | 93cded47a2732cadddca657ae04721f38e86bbf0 (diff) | |
download | portage-13a1d0e6247bd227afd0c9738093e663a989ac30.tar.gz portage-13a1d0e6247bd227afd0c9738093e663a989ac30.tar.bz2 portage-13a1d0e6247bd227afd0c9738093e663a989ac30.zip |
Bug #273622 - Add docs for pkg_pretend from PMS 10.1.2.
-rw-r--r-- | doc/package/ebuild/eapi/4.docbook | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/package/ebuild/eapi/4.docbook b/doc/package/ebuild/eapi/4.docbook index 8d7942b47..9181aa881 100644 --- a/doc/package/ebuild/eapi/4.docbook +++ b/doc/package/ebuild/eapi/4.docbook @@ -109,4 +109,26 @@ Finally, please note that this new metadata key can be set by eclasses, and the </section> </section> </section> + <section id='package-ebuild-eapi-4_pre1-phases'> + <title>Phases</title> + <section id='package-ebuild-eapi-4_pre1-phases-pkg-pretend'> + <title>New pkg_pretend Phase Function</title> + <para> + The pkg_pretend function may be used to carry out sanity checks early on in the + install process. For example, if an ebuild requires a particular kernel + configuration, it may perform that check in pkg_pretend and call eerror and + then die with appropriate messages if the requirement is not met. + </para> + <para> + pkg_pretend is run separately from the main phase function sequence, and does + not participate in any kind of environment saving. There is no guarantee that + any of an ebuild's dependencies will be met at this stage, and no guarantee + that the system state will not have changed substantially before the next phase + is executed. + </para> + <para> + pkg_pretend must not write to the filesystem. + </para> + </section> + </section> </section> |