ebuild(5): pkg_pretend in EAPI 4
authorZac Medico <zmedico@gentoo.org>
Fri, 31 Dec 2010 03:58:14 +0000 (19:58 -0800)
committerZac Medico <zmedico@gentoo.org>
Fri, 31 Dec 2010 03:58:14 +0000 (19:58 -0800)
man/ebuild.5

index 9ceee590d538d54105780181b702f5665996c2d6..691adc055daeb5f6db7bbc600e2ce901f74c7de4 100644 (file)
@@ -596,6 +596,15 @@ before other variable declarations unless these variables are used in global
 scope of eclasses.
 .SH "PHASE FUNCTIONS"
 .TP
+.B pkg_pretend
+Beginning with \fBEAPI 4\fR, this function can be defined in order to
+check that miscellaneous requirements are met. It is called as early
+as possible, before any attempt is made to satisfy dependencies. If the
+function detects a problem then it should call eerror and die. The
+environment (variables, functions, temporary directories, etc..) that
+is used to execute pkg_pretend is not saved and therefore is not
+available in phases that execute afterwards.
+.TP
 .B pkg_nofetch
 If you turn on \fIfetch\fR in \fBRESTRICT\fR, then this function will be
 run when the files in \fBSRC_URI\fR cannot be found.  Useful for