Add some docs for EAPI 2_pre2.

svn path=/main/trunk/; revision=11328

diff --git a/doc/package/ebuild/eapi/2.docbook b/doc/package/ebuild/eapi/2.docbook
index 2b1fa56980bd06f0f33dcfd88cb72b41719a9b81..dc2e0dc0a51b8d8e03968f1b42eff6b17ea15fc1 100644 (file)
--- 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>