commit: c6e5ee2b40f491089980056f4c4d737469282887
Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Mon Jun 13 15:50:21 2016 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Thu Jun 16 01:15:58 2016 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=c6e5ee2b
ebuild-writing/.../epatch: suggest compressing patches with xz
With app-arch/xz-utils being in @system, suggest patches to be
compressed with xz as it achieves higher compression rates than bzip2.
Also replace 'files/' with '${FILESDIR}' and add a link to the
variables page.
Reported-by: dracwyrm <j.scruggs <AT> gmail.com>
ebuild-writing/functions/src_prepare/epatch/text.xml | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)
diff --git a/ebuild-writing/functions/src_prepare/epatch/text.xml
b/ebuild-writing/functions/src_prepare/epatch/text.xml
index a8d5f04..a3adfb5 100644
--- a/ebuild-writing/functions/src_prepare/epatch/text.xml
+++ b/ebuild-writing/functions/src_prepare/epatch/text.xml
@@ -37,11 +37,14 @@ src_unpack() {
</codesample>
<p>
-For larger patches, using <uri
link="::general-concepts/mirrors/#suitable-download-hosts">your devspace</uri>
rather
-than <c>files/</c> is more appropriate. In these situations, it is
-usually best to <c>bzip2</c> the patch in question (as opposed to
-<c>files/</c> patches, which must not be compressed). For example,
-from <c>app-admin/showconsole</c>:
+For larger patches, using
+<uri link="::general-concepts/mirrors/#suitable-download-hosts">
+your devspace</uri> rather than
+<uri link="::ebuild-writing/variables#Predefined Read-Only Variables">
+${FILESDIR}</uri> is more appropriate. In these situations, it is
+usually best to compress the patch in question with <c>xz</c> or
+<c>bzip2</c>(as opposed to <c>${FILESDIR}</c> patches, which must not
+be compressed). For example, from <c>app-admin/showconsole</c>:
</p>
<codesample lang="ebuild">
