From 287a6a91b3736b5cf732f848efcafa8014413b1a Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Tue, 20 Dec 2011 12:14:05 -0800
Subject: [PATCH] Add some EAPI 4-python docs.

---
 doc/package/ebuild.docbook               |  1 +
 doc/package/ebuild/eapi/4-python.docbook | 49 ++++++++++++++++++++++++
 doc/portage.docbook                      |  1 +
 3 files changed, 51 insertions(+)
 create mode 100644 doc/package/ebuild/eapi/4-python.docbook

diff --git a/doc/package/ebuild.docbook b/doc/package/ebuild.docbook
index 20bdaf794..e771d3ae1 100644
--- a/doc/package/ebuild.docbook
+++ b/doc/package/ebuild.docbook
@@ -9,5 +9,6 @@
 &package_ebuild_eapi_2;
 &package_ebuild_eapi_3;
 &package_ebuild_eapi_4;
+&package_ebuild_eapi_4_python;
 </section>
 </chapter>
diff --git a/doc/package/ebuild/eapi/4-python.docbook b/doc/package/ebuild/eapi/4-python.docbook
new file mode 100644
index 000000000..0a60013f4
--- /dev/null
+++ b/doc/package/ebuild/eapi/4-python.docbook
@@ -0,0 +1,49 @@
+<section id='package-ebuild-eapi-4-python'>
+<title>EAPI 4-python</title>
+<para>Also see the
+<ulink url="http://people.apache.org/~Arfrever/EAPI_4-python_Specification">
+official EAPI 4-python Specification</ulink>.
+</para>
+<section id='package-ebuild-eapi-4-python-helpers'>
+<title>Helpers</title>
+<section id='package-ebuild-eapi-4-python-helpers-banned-global-scope'>
+<title>Helpers Banned in Global Scope</title>
+<para>
+<itemizedlist>
+<listitem><para>diropts</para></listitem>
+<listitem><para>docompress</para></listitem>
+<listitem><para>exeopts</para></listitem>
+<listitem><para>insopts</para></listitem>
+<listitem><para>keepdir</para></listitem>
+<listitem><para>libopts</para></listitem>
+<listitem><para>use</para></listitem>
+<listitem><para>use_enable</para></listitem>
+<listitem><para>use_with</para></listitem>
+<listitem><para>useq</para></listitem>
+<listitem><para>usev</para></listitem>
+</itemizedlist>
+</para>
+</section>
+</section>
+<section id='package-ebuild-eapi-4-python-use-flag-allow-period-characters'>
+<title>Support for Period Characters in USE Flags</title>
+<para>
+The "." character is allowed in USE flags.
+</para>
+</section>
+<section id='package-ebuild-eapi-4-python-repo-level-config'>
+<title>Extended Repository-Level Configuration</title>
+<para>
+Repository-level configuration in ${repository}/profiles is supported for
+the following files:
+<itemizedlist>
+<listitem><para>make.defaults</para></listitem>
+<listitem><para>package.use</para></listitem>
+<listitem><para>package.use.force</para></listitem>
+<listitem><para>package.use.mask</para></listitem>
+<listitem><para>use.force</para></listitem>
+<listitem><para>use.mask</para></listitem>
+</itemizedlist>
+</para>
+</section>
+</section>
diff --git a/doc/portage.docbook b/doc/portage.docbook
index 3a221db6b..c0121b8d0 100644
--- a/doc/portage.docbook
+++ b/doc/portage.docbook
@@ -20,6 +20,7 @@
 	<!ENTITY package_ebuild_eapi_2 SYSTEM "package/ebuild/eapi/2.docbook">
 	<!ENTITY package_ebuild_eapi_3 SYSTEM "package/ebuild/eapi/3.docbook">
 	<!ENTITY package_ebuild_eapi_4 SYSTEM "package/ebuild/eapi/4.docbook">
+	<!ENTITY package_ebuild_eapi_4_python SYSTEM "package/ebuild/eapi/4-python.docbook">
 	<!ENTITY qa SYSTEM "qa.docbook">
 	<!ENTITY config SYSTEM "config.docbook">
 	<!ENTITY config_bashrc SYSTEM "config/bashrc.docbook">
-- 
2.26.2