diff options
author | Zac Medico <zmedico@gentoo.org> | 2010-08-28 16:27:54 -0700 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2010-08-28 16:27:54 -0700 |
commit | d878e28bdfb2459d56310203754253fefddfb251 (patch) | |
tree | 3f7a83dbe28f03a453f48868e2a9b37e112bd117 | |
parent | 0b5b8064ce7dfac969d4fcfb2b0b0eb95f92a605 (diff) | |
download | portage-d878e28bdfb2459d56310203754253fefddfb251.tar.gz portage-d878e28bdfb2459d56310203754253fefddfb251.tar.bz2 portage-d878e28bdfb2459d56310203754253fefddfb251.zip |
Bug #273633 - Add docompress docs from PMS.
-rw-r--r-- | doc/package/ebuild/eapi/4.docbook | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/package/ebuild/eapi/4.docbook b/doc/package/ebuild/eapi/4.docbook index b5b570eeb..e69b698db 100644 --- a/doc/package/ebuild/eapi/4.docbook +++ b/doc/package/ebuild/eapi/4.docbook @@ -16,6 +16,58 @@ Helper calls may be prefixed with the 'nonfatal' helper in order to prevent errors from being fatal. </para> </section> +<section id='package-ebuild-eapi-4_pre1-helpers-docompress'> +<title>Controllable Compression</title> +<para> +In EAPI 4, the package manager may optionally compress +a subset of the files under the D +directory. To control which directories may or may not be compressed, the +package manager shall maintain two lists: +<itemizedlist> +<listitem><para>An inclusion list, which initially contains /usr/share/doc, /usr/share/info +and /usr/share/man.</para></listitem> +<listitem><para>An exclusion list, which initially contains /usr/share/doc/${PF}/html.</para></listitem> +</itemizedlist> +</para> +<para> +The optional compression shall be carried out after src_install has completed, +and before the execution of any subsequent phase function. For each item in the +inclusion list, pretend it has the value of the D variable prepended, then: +<itemizedlist> +<listitem><para>If it is a directory, act as if every file or directory immediately under +this directory were in the inclusion list.</para></listitem> +<listitem><para>If the item is a file, it may be compressed unless it has been excluded as +described below.</para></listitem> +<listitem><para>If the item does not exist, it is ignored.</para></listitem> +</itemizedlist> +</para> +<para> +Whether an item is to be excluded is determined as follows: For each item in +the exclusion list, pretend it has the value of the D variable prepended, then: +<itemizedlist> +<listitem><para>If it is a directory, act as if every file or directory immediately under +this directory were in the exclusion list.</para></listitem> +<listitem><para>If the item is a file, it shall not be compressed.</para></listitem> +<listitem><para>If the item does not exist, it is ignored.</para></listitem> +</itemizedlist> +</para> +<para> +The package manager shall take appropriate steps to ensure that its compression +mechanisms behave sensibly even if an item is listed in the inclusion list +multiple times, if an item is a symlink, or if a file is already compressed. +</para> +<para> +The following commands may be used in src_install to alter these lists. It is +an error to call any of these functions from any other phase. +</para> +<section id='package-ebuild-eapi-4_pre1-helpers-docompress-command'> +<title>docompress helper</title> +<para> +If the first argument is -x, add each of its subsequent arguments to the +exclusion list. Otherwise, add each argument to the inclusion list. +</para> +</section> +</section> <section id='package-ebuild-eapi-4_pre1-helpers-dodoc-r'> <title>dodoc -r</title> <para> |