From c8c10f8c9ca2624481ef43775c9fa94ec6864241 Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Sun, 10 Aug 2008 04:56:54 +0000
Subject: [PATCH] Document the differences between EAPIs 0 and 1.

svn path=/main/trunk/; revision=11384
---
 doc/package/ebuild/eapi/0.docbook | 16 ++++++++++
 doc/package/ebuild/eapi/1.docbook | 51 +++++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+)

diff --git a/doc/package/ebuild/eapi/0.docbook b/doc/package/ebuild/eapi/0.docbook
index bba6db93c..72e998b9c 100644
--- a/doc/package/ebuild/eapi/0.docbook
+++ b/doc/package/ebuild/eapi/0.docbook
@@ -1,3 +1,19 @@
 <sect1 id='package-ebuild-eapi-0'>
 	<title>EAPI 0</title>
+	<sect2 id='package-ebuild-eapi-0-phases'>
+		<title>Phases</title>
+		<sect3 id='package-ebuild-eapi-0-phases-default-src-compile'>
+			<title>Default src_compile Phase Function</title>
+			<programlisting>
+src_compile() {
+	if [ -x ./configure ] ; then
+		econf
+	fi
+	if [ -f Makefile ] || [ -f GNUmakefile ] || [ -f makefile ] ; then
+		emake || die "emake failed"
+	fi
+}
+			</programlisting>
+		</sect3>
+	</sect2>
 </sect1>
diff --git a/doc/package/ebuild/eapi/1.docbook b/doc/package/ebuild/eapi/1.docbook
index 0cc3df75c..ad84ae6f9 100644
--- a/doc/package/ebuild/eapi/1.docbook
+++ b/doc/package/ebuild/eapi/1.docbook
@@ -1,3 +1,54 @@
 <sect1 id='package-ebuild-eapi-1'>
 	<title>EAPI 1</title>
+	<sect2 id='package-ebuild-eapi-1-phases'>
+		<title>Phases</title>
+		<sect3 id='package-ebuild-eapi-1-phases-default-src-compile'>
+			<title>Default src_compile Phase Function</title>
+			<para>
+			Support for the ECONF_SOURCE variable, which is also supported
+			by econf, has been added to the default src_compile implementation.
+			</para>
+			<programlisting>
+src_compile() {
+	if [[ -x ${ECONF_SOURCE:-.}/configure ]] ; then
+		econf
+	fi
+	if [ -f Makefile ] || [ -f GNUmakefile ] || [ -f makefile ] ; then
+		emake || die "emake failed"
+	fi
+}
+			</programlisting>
+		</sect3>
+	</sect2>
+	<sect2 id='package-ebuild-eapi-1-slot-deps'>
+	<title>SLOT Dependencies</title>
+	<para>
+	Any valid atom can be constrained to match a specific SLOT. This is
+	accomplished by appending a colon to the atom, followed by a SLOT value.
+	</para>
+	<table><title>Slot Dependency Examples</title>
+	<tgroup cols='1' align='left' >
+	<colspec colname='atom'/>
+	<thead>
+	<row>
+	<entry>Atom</entry>
+	</row>
+	</thead>
+	<tbody>
+	<row>
+	<entry>x11-libs/qt:3</entry>
+	</row>
+	<row>
+	<entry>~x11-libs/qt-3.3.8:3</entry>
+	</row>
+	<row>
+	<entry>&gt;=x11-libs/qt-3.3.8:3</entry>
+	</row>
+	<row>
+	<entry>=x11-libs/qt-3.3*:3</entry>
+	</row>
+	</tbody>
+	</tgroup>
+	</table>
+	</sect2>
 </sect1>
-- 
2.26.2