Gentoo Archives: gentoo-commits

From: "Zac Medico (zmedico)" <zmedico@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] portage r11328 - main/trunk/doc/package/ebuild/eapi
Date: Mon, 04 Aug 2008 19:07:39
Message-Id: E1KQ5P6-0005uk-QW@stork.gentoo.org
1 Author: zmedico
2 Date: 2008-08-04 19:07:35 +0000 (Mon, 04 Aug 2008)
3 New Revision: 11328
4
5 Modified:
6 main/trunk/doc/package/ebuild/eapi/2.docbook
7 Log:
8 Add some docs for EAPI 2_pre2.
9
10
11 Modified: main/trunk/doc/package/ebuild/eapi/2.docbook
12 ===================================================================
13 --- main/trunk/doc/package/ebuild/eapi/2.docbook 2008-08-04 17:54:12 UTC (rev 11327)
14 +++ main/trunk/doc/package/ebuild/eapi/2.docbook 2008-08-04 19:07:35 UTC (rev 11328)
15 @@ -1,4 +1,4 @@
16 -<sect1 id='package-ebuild-eapi-2'>
17 +<sect1 id='package-ebuild-eapi-2_pre1'>
18 <title>EAPI 2_pre1</title>
19 <sect2 id='package-ebuild-eapi-2-helpers'>
20 <title>Helpers</title>
21 @@ -97,3 +97,71 @@
22 </sect3>
23 </sect2>
24 </sect1>
25 +<sect1 id='package-ebuild-eapi-2_pre2'>
26 + <title>EAPI 2_pre2</title>
27 + <sect2 id='package-ebuild-eapi-2-phases'>
28 + <title>Phases</title>
29 + <sect3 id='package-ebuild-eapi-2-phases-src-configure'>
30 + <title>New src_configure Phase Function</title>
31 + <para>
32 + The configure portion of the src_compile function has been
33 + split into a separate function which is named src_configure. The
34 + src_configure function is called in between the src_unpack and
35 + src_compile functions.
36 + </para>
37 + <table><title>Execution Order of Phase Functions</title>
38 + <tgroup cols='1' align='left' >
39 + <colspec colname='name'/>
40 + <thead>
41 + <row>
42 + <entry>Phase Function Name</entry>
43 + </row>
44 + </thead>
45 + <tbody>
46 + <row>
47 + <entry>pkg_setup</entry>
48 + </row>
49 + <row>
50 + <entry>src_unpack</entry>
51 + </row>
52 + <row>
53 + <entry>src_configure</entry>
54 + </row>
55 + <row>
56 + <entry>src_compile</entry>
57 + </row>
58 + <row>
59 + <entry>src_test</entry>
60 + </row>
61 + <row>
62 + <entry>src_install</entry>
63 + </row>
64 + <row>
65 + <entry>pkg_preinst</entry>
66 + </row>
67 + <row>
68 + <entry>pkg_postinst</entry>
69 + </row>
70 + <row>
71 + <entry>pkg_prerm</entry>
72 + </row>
73 + <row>
74 + <entry>pkg_postrm</entry>
75 + </row>
76 + </tbody>
77 + </tgroup>
78 + </table>
79 + </sect3>
80 + <sect3 id='package-ebuild-eapi-2-phases-default-functions'>
81 + <title>Default Phase Functions</title>
82 + <para>
83 + Each of the default src_* phase functions is now accessible
84 + via a function having a name that begins with default_ and
85 + ends with the respective phase function name. For example,
86 + a call to a function with the name default_src_compile is
87 + equivalent to a call to the default src_compile
88 + implementation.
89 + </para>
90 + </sect3>
91 + </sect2>
92 +</sect1>