From 5e4955ba3383eb5279e6b3577ee85fd190ca1bf8 Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Mon, 28 Jul 2008 08:41:41 +0000
Subject: [PATCH] Create a table to document conditional USE dependency syntax.

svn path=/main/trunk/; revision=11235
---
 doc/package/ebuild.docbook        |  1 +
 doc/package/ebuild/eapi/2.docbook | 39 +++++++++++++++++++++++++++++++
 doc/portage.docbook               |  1 +
 3 files changed, 41 insertions(+)
 create mode 100644 doc/package/ebuild/eapi/2.docbook

diff --git a/doc/package/ebuild.docbook b/doc/package/ebuild.docbook
index 4bdb8129d..fa4f75609 100644
--- a/doc/package/ebuild.docbook
+++ b/doc/package/ebuild.docbook
@@ -2,4 +2,5 @@
 <title>Ebuild</title>
 &package_ebuild_phases;
 &package_ebuild_helper_functions;
+&package_ebuild_eapi_2;
 </chapter>
diff --git a/doc/package/ebuild/eapi/2.docbook b/doc/package/ebuild/eapi/2.docbook
new file mode 100644
index 000000000..594eceabe
--- /dev/null
+++ b/doc/package/ebuild/eapi/2.docbook
@@ -0,0 +1,39 @@
+<sect1 id='package-ebuild-eapi-2'>
+	<title>EAPI 2_pre0</title>
+	<sect2 id='package-ebuild-eapi-2-use-deps'>
+	<title>USE Dependencies</title>
+	<sect3 id='package-ebuild-eapi-2-use-deps-conditional'>
+	<title>Conditional USE Dependencies</title>
+	<table><title>Syntax Examples</title>
+	<tgroup cols='2' align='left' >
+	<colspec colname='compact'/>
+	<colspec colname='expanded'/>
+	<thead>
+	<row>
+	<entry>Compact Form</entry>
+	<entry>Equivalent Expanded Form</entry>
+	</row>
+	</thead>
+	<tbody>
+	<row>
+	<entry>foo[bar?]</entry>
+	<entry>foo  bar? (  foo[bar] )</entry>
+	</row>
+	<row>
+	<entry>foo[-bar?]</entry>
+	<entry>foo !bar? ( foo[-bar] )</entry>
+	</row>
+	<row>
+	<entry>foo[bar=]</entry>
+	<entry>foo  bar? (  foo[bar] ) !bar? ( foo[-bar] )</entry>
+	</row>
+	<row>
+	<entry>foo[bar!=]</entry>
+	<entry>foo  bar? ( foo[-bar] ) !bar? (  foo[bar] )</entry>
+	</row>
+	</tbody>
+	</tgroup>
+	</table>
+	</sect3>
+	</sect2>
+</sect1>
diff --git a/doc/portage.docbook b/doc/portage.docbook
index 8c29303e6..c038079a2 100644
--- a/doc/portage.docbook
+++ b/doc/portage.docbook
@@ -15,6 +15,7 @@
 	<!ENTITY package_ebuild SYSTEM "package/ebuild.docbook">
 	<!ENTITY package_ebuild_phases SYSTEM "package/ebuild/phases.docbook">
 	<!ENTITY package_ebuild_helper_functions SYSTEM "package/ebuild/helper_functions.docbook">
+	<!ENTITY package_ebuild_eapi_2 SYSTEM "package/ebuild/eapi/2.docbook">
 	<!ENTITY qa SYSTEM "qa.docbook">
 	<!ENTITY config SYSTEM "config.docbook">
 	<!ENTITY config_bashrc SYSTEM "config/bashrc.docbook">
-- 
2.26.2