From 4177dcea4849b33347f064b8f0dc4df625350bd4 Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Mon, 4 Aug 2008 19:07:35 +0000
Subject: Add some docs for EAPI 2_pre2.

svn path=/main/trunk/; revision=11328
---
 doc/package/ebuild/eapi/2.docbook | 70 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 69 insertions(+), 1 deletion(-)

(limited to 'doc/package/ebuild')

diff --git a/doc/package/ebuild/eapi/2.docbook b/doc/package/ebuild/eapi/2.docbook
index 2b1fa5698..dc2e0dc0a 100644
--- a/doc/package/ebuild/eapi/2.docbook
+++ b/doc/package/ebuild/eapi/2.docbook
@@ -1,4 +1,4 @@
-<sect1 id='package-ebuild-eapi-2'>
+<sect1 id='package-ebuild-eapi-2_pre1'>
 	<title>EAPI 2_pre1</title>
 	<sect2 id='package-ebuild-eapi-2-helpers'>
 	<title>Helpers</title>
@@ -97,3 +97,71 @@
 	</sect3>
 	</sect2>
 </sect1>
+<sect1 id='package-ebuild-eapi-2_pre2'>
+	<title>EAPI 2_pre2</title>
+	<sect2 id='package-ebuild-eapi-2-phases'>
+		<title>Phases</title>
+		<sect3 id='package-ebuild-eapi-2-phases-src-configure'>
+			<title>New src_configure Phase Function</title>
+			<para>
+			The configure portion of the src_compile function has been
+			split into a separate function which is named src_configure. The
+			src_configure function is called in between the src_unpack and
+			src_compile functions.
+			</para>
+			<table><title>Execution Order of Phase Functions</title>
+				<tgroup cols='1' align='left' >
+				<colspec colname='name'/>
+				<thead>
+				<row>
+					<entry>Phase Function Name</entry>
+				</row>
+				</thead>
+				<tbody>
+				<row>
+					<entry>pkg_setup</entry>
+				</row>
+				<row>
+					<entry>src_unpack</entry>
+				</row>
+				<row>
+					<entry>src_configure</entry>
+				</row>
+				<row>
+					<entry>src_compile</entry>
+				</row>
+				<row>
+					<entry>src_test</entry>
+				</row>
+				<row>
+					<entry>src_install</entry>
+				</row>
+				<row>
+					<entry>pkg_preinst</entry>
+				</row>
+				<row>
+					<entry>pkg_postinst</entry>
+				</row>
+				<row>
+					<entry>pkg_prerm</entry>
+				</row>
+				<row>
+					<entry>pkg_postrm</entry>
+				</row>
+				</tbody>
+				</tgroup>
+			</table>
+		</sect3>
+		<sect3 id='package-ebuild-eapi-2-phases-default-functions'>
+			<title>Default Phase Functions</title>
+			<para>
+			Each of the default src_* phase functions is now accessible
+			via a function having a name that begins with default_ and
+			ends with the respective phase function name. For example,
+			a call to a function with the name default_src_compile is
+			equivalent to a call to the default src_compile
+			implementation.
+			</para>
+		</sect3>
+	</sect2>
+</sect1>
-- 
cgit v1.2.3-1-g7c22