diff options
authorJens Schweikhardt <schweikh@FreeBSD.org>2004-01-20 20:36:37 +0000
committerJens Schweikhardt <schweikh@FreeBSD.org>2004-01-20 20:36:37 +0000
commit65578e98e3888b1cad40e4f0bd07bfa16aeea15c (patch)
parentf993e774b214d2ab2e8e0a0a21a401e7440d6d0a (diff)
Add section on EXTRACT_DEPENDS.
PR: 61361, part of 56452 Submitted by: schweikh, Kang Liu <liukang@bjpu.edu.cn>
Notes: svn path=/head/; revision=19759
1 files changed, 27 insertions, 1 deletions
diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index eaea24b66e..b90dc98d3c 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -2968,6 +2968,32 @@ PATCHFILES= patch1:test</programlisting>
+ <title><makevar>EXTRACT_DEPENDS</makevar></title>
+ <para>This variable specifies executables or files this port
+ requires for extraction. Like the previous, it is a list of
+ <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>
+ tuples. For example, <programlisting>EXTRACT_DEPENDS=
+ unzip:${PORTSDIR}/archivers/unzip</programlisting> will check
+ for an executable called <command>unzip</command>, and descend
+ into the <filename>archivers/unzip</filename> subdirectory of
+ your ports tree to build and install it if it is not found.</para>
+ <para>The dependency is checked from within the
+ <maketarget>extract</maketarget> target. The
+ <replaceable>target</replaceable> part can be omitted if it is the
+ same as <makevar>DEPENDS_TARGET</makevar>.</para>
+ <note>
+ <para>Use this variable only if the extraction does not already
+ work (the default assumes <command>gzip</command>) and cannot
+ be made to work using <makevar>USE_ZIP</makevar> or
+ <makevar>USE_BZIP2</makevar> described in <xref
+ linkend="use-vars">.
+ </note>
+ </sect2>
+ <sect2>
<para>If there is a dependency that does not fall into either of the
@@ -2980,7 +3006,7 @@ PATCHFILES= patch1:test</programlisting>
same as <makevar>DEPENDS_TARGET</makevar>.</para>
- <sect2>
+ <sect2 id="use-vars">
<para>A number of variables exist in order to encapsulate common