[pkgsrc/trunk]: pkgsrc/doc/guide/files Update for FETCH_USING changes.

[joerg <joerg%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/0c8d77039f25
branches:  trunk
changeset: 554227:0c8d77039f25
user:      joerg <joerg%pkgsrc.org@localhost>
date:      Tue Feb 10 19:24:37 2009 +0000

description:
Update for FETCH_USING changes.

diffstat:

 doc/guide/files/build.xml |   6 +++++-
 doc/guide/files/faq.xml   |  18 +++++++++---------
 2 files changed, 14 insertions(+), 10 deletions(-)

diffs (58 lines):

diff -r 0619036995d6 -r 0c8d77039f25 doc/guide/files/build.xml
--- a/doc/guide/files/build.xml Tue Feb 10 18:55:54 2009 +0000
+++ b/doc/guide/files/build.xml Tue Feb 10 19:24:37 2009 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.56 2008/09/09 00:59:51 obache Exp $ -->
+<!-- $NetBSD: build.xml,v 1.57 2009/02/10 19:24:37 joerg Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -382,6 +382,10 @@
       <varname>MASTER_SORT_AWK</varname> or
       <varname>MASTER_SORT_REGEX</varname>.</para>
 
+      <para> The specific command and arguments used depend on the
+      <varname>FETCH_USING</varname> parameter. The example above is
+      for <literal>FETCH_USING=custom</literal>.
+
       <para>The distfiles mirror run by the NetBSD Foundation uses the
       <emphasis>mirror-distfiles</emphasis> target to mirror the
       distfiles, if they are freely distributable.  Packages setting
diff -r 0619036995d6 -r 0c8d77039f25 doc/guide/files/faq.xml
--- a/doc/guide/files/faq.xml   Tue Feb 10 18:55:54 2009 +0000
+++ b/doc/guide/files/faq.xml   Tue Feb 10 19:24:37 2009 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: faq.xml,v 1.41 2009/01/28 23:31:39 abs Exp $ -->
+<!-- $NetBSD: faq.xml,v 1.42 2009/02/10 19:24:37 joerg Exp $ -->
 
 <chapter id="faq"> <?dbhtml filename="faq.html"?>
 <title>Frequently Asked Questions</title>
@@ -275,20 +275,20 @@
 
 <para>You can also
 use a different program than the default &man.ftp.1; by changing the
-<varname>FETCH_CMD</varname> variable.  Don't forget to set
-<varname>FETCH_RESUME_ARGS</varname> and
-<varname>FETCH_OUTPUT_ARGS</varname> if you are not using default
-values.</para>
+<varname>FETCH_USING</varname> variable.  You can specify the program by
+using of ftp, fetch, wget or curl.  Alternatively, fetching can be disabled
+by using the value manual.  A value of custom disables the system defaults
+and dependency tracking for the fetch program.  In that case you have to
+provide <varname>FETCH_CMD</varname>, <varname>FETCH_BEFORE_ARGS</varname>,
+<varname>FETCH_RESUME_ARGS</varname>, <varname>FETCH_OUTPUT_ARGS</varname>
+<varname>FETCH_AFTER_ARGS<v/varname>.</para>
 
 <para>For example, if you want to use
 <filename>wget</filename> to resume downloads, you'll have to use something
 like:</para>
 
 <programlisting>
-FETCH_CMD=             wget
-FETCH_BEFORE_ARGS=     --passive-ftp
-FETCH_RESUME_ARGS=     -c
-FETCH_OUTPUT_ARGS=     -O -nc
+FETCH_USING=   wget
 </programlisting>
 
 </sect1>