Support EAPI="5-progress".

3 files changed, 135 insertions, 0 deletions

diff --git a/doc/package/ebuild.docbook b/doc/package/ebuild.docbook
index e268a3d11..98084c8fa 100644
--- a/doc/package/ebuild.docbook
+++ b/doc/package/ebuild.docbook
@@ -12,5 +12,6 @@
 &package_ebuild_eapi_4_python;
 &package_ebuild_eapi_4_slot_abi;
 &package_ebuild_eapi_5;
+&package_ebuild_eapi_5_progress;
 </section>
 </chapter>
diff --git a/doc/package/ebuild/eapi/5-progress.docbook b/doc/package/ebuild/eapi/5-progress.docbook
new file mode 100644
index 000000000..142ff8e2e
--- /dev/null
+++ b/doc/package/ebuild/eapi/5-progress.docbook
@@ -0,0 +1,133 @@
+<section id='package-ebuild-eapi-5-progress'>
+	<title>EAPI 5-progress</title>
+	<para>
+		Also see the <ulink url="http://people.apache.org/~Arfrever/EAPI_5-progress_Specification">official EAPI 5-progress Specification</ulink>.
+	</para>
+	<section id='package-ebuild-eapi-5-progress-helpers'>
+		<title>Helpers</title>
+		<section id='package-ebuild-eapi-5-progress-helpers-dohtml-extended-default-list-of-extensions'>
+			<title>Extended default list of extensions in dohtml</title>
+			<para>
+				dohtml by default additionally installs files with .ico, .svg, .xhtml and .xml extensions.
+			</para>
+		</section>
+		<section id='package-ebuild-eapi-5-progress-helpers-banned-in-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-5-progress-metadata'>
+		<title>Metadata</title>
+		<section id='package-ebuild-eapi-5-progress-metadata-package-names-allow-period-characters'>
+			<title>Support for Period Characters in Package Names</title>
+			<para>
+				The "." character is allowed in package names.
+			</para>
+		</section>
+		<section id='package-ebuild-eapi-5-progress-metadata-use-flags-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-5-progress-metadata-repository-dependencies'>
+			<title>Repository Dependencies</title>
+			<para>
+				Repository dependencies are supported in atoms in DEPEND, PDEPEND and RDEPEND and atoms passed to best_version and has_version functions.
+				Repository dependency is specified by two colons followed by repository name.
+			</para>
+			<table><title>Repository Dependency Examples</title>
+				<tgroup cols='1' align='left'>
+					<colspec colname='atom'/>
+					<thead>
+						<row>
+							<entry>Atom</entry>
+						</row>
+					</thead>
+					<tbody>
+						<row>
+							<entry>dev-lang/python::progress</entry>
+						</row>
+						<row>
+							<entry>&gt;=dev-lang/python-3.2::progress</entry>
+						</row>
+						<row>
+							<entry>dev-lang/python:3.2::progress</entry>
+						</row>
+						<row>
+							<entry>dev-lang/python::progress[xml]</entry>
+						</row>
+						<row>
+							<entry>dev-lang/python:3.2::progress[xml]</entry>
+						</row>
+					</tbody>
+				</tgroup>
+			</table>
+		</section>
+	</section>
+	<section id='package-ebuild-eapi-5-progress-globstar'>
+		<title>globstar shell option enabled by default</title>
+		<para>
+			globstar shell option is enabled by default, which enables recursive expansion of ** pattern in pathname expansion context.
+		</para>
+	</section>
+	<section id='package-ebuild-eapi-5-progress-variables'>
+		<title>Variables</title>
+		<section id='package-ebuild-eapi-5-progress-variables-repository'>
+			<title>REPOSITORY Variable</title>
+			<para>
+				The new REPOSITORY variable is set in ebuild environment. This variable contains name of repository, which contains currently used ebuild.
+			</para>
+		</section>
+	</section>
+	<section id='package-ebuild-eapi-5-progress-repo-level-config'>
+		<title>Extended Repository-Level Configuration</title>
+		<para>
+			Repository-level configuration in ${repository_path}/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>package.use.stable.force</para></listitem>
+				<listitem><para>package.use.stable.mask</para></listitem>
+				<listitem><para>use.force</para></listitem>
+				<listitem><para>use.mask</para></listitem>
+				<listitem><para>use.stable.force</para></listitem>
+				<listitem><para>use.stable.mask</para></listitem>
+			</itemizedlist>
+		</para>
+	</section>
+	<section id='package-ebuild-eapi-5-progress-directories'>
+		<title>Directories Allowed for Profile-Level and Repository-Level Configuration</title>
+		<para>
+			The following files can be directories:
+			<itemizedlist>
+				<listitem><para>package.mask</para></listitem>
+				<listitem><para>package.use</para></listitem>
+				<listitem><para>package.use.force</para></listitem>
+				<listitem><para>package.use.mask</para></listitem>
+				<listitem><para>package.use.stable.force</para></listitem>
+				<listitem><para>package.use.stable.mask</para></listitem>
+				<listitem><para>use.force</para></listitem>
+				<listitem><para>use.mask</para></listitem>
+				<listitem><para>use.stable.force</para></listitem>
+				<listitem><para>use.stable.mask</para></listitem>
+			</itemizedlist>
+		</para>
+	</section>
+</section>
diff --git a/doc/portage.docbook b/doc/portage.docbook
index f5803141e..04db26303 100644
--- a/doc/portage.docbook
+++ b/doc/portage.docbook
@@ -23,6 +23,7 @@
 	<!ENTITY package_ebuild_eapi_4_python SYSTEM "package/ebuild/eapi/4-python.docbook">
 	<!ENTITY package_ebuild_eapi_4_slot_abi SYSTEM "package/ebuild/eapi/4-slot-abi.docbook">
 	<!ENTITY package_ebuild_eapi_5 SYSTEM "package/ebuild/eapi/5.docbook">
+	<!ENTITY package_ebuild_eapi_5_progress SYSTEM "package/ebuild/eapi/5-progress.docbook">
 	<!ENTITY qa SYSTEM "qa.docbook">
 	<!ENTITY config SYSTEM "config.docbook">
 	<!ENTITY config_bashrc SYSTEM "config/bashrc.docbook">