[pkgsrc/trunk]: pkgsrc/doc/guide/files INTERACTIVE_STAGE should not be set to...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/2492eb268132
branches:  trunk
changeset: 515281:2492eb268132
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Fri Jun 30 09:41:39 2006 +0000

description:
INTERACTIVE_STAGE should not be set to "fetch".

diffstat:

 doc/guide/files/fixes.xml |  17 ++++++++++++-----
 1 files changed, 12 insertions(+), 5 deletions(-)

diffs (52 lines):

diff -r 57e8584b1a7c -r 2492eb268132 doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Fri Jun 30 09:25:34 2006 +0000
+++ b/doc/guide/files/fixes.xml Fri Jun 30 09:41:39 2006 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.58 2006/06/29 11:41:04 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.59 2006/06/30 09:41:39 rillig Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
   <title>Making your package work</title>
@@ -46,12 +46,13 @@
     </sect2>
 
     <sect2 id="user-interaction">
-      <title>User interaction</title>
+      <title>User interaction when building the package</title>
 
       <para>Occasionally, packages require interaction from the user, and this can be
         in a number of ways:</para>
 
       <itemizedlist>
+
        <listitem>
          <para>When extracting the distfiles, some packages may ask for passwords.</para>
        </listitem>
@@ -82,9 +83,16 @@
 <programlisting>
     INTERACTIVE_STAGE=      configure install
 </programlisting>
+
+       <para>You should not use <varname>INTERACTIVE_STAGE</varname>
+       when fetching the distfiles needs to be done manually. See <xref
+       linkend="fixes.fetch"/> instead. The reason for this is that
+       fetching the distfiles is only needed once, where the phases in
+       <varname>INTERACTIVE_STAGE</varname> are needed everytime when
+       building the package.</para>
+
     </sect2>
 
-
     <sect2 id="handling-licenses">
       <title>Handling licenses</title>
 
@@ -567,8 +575,7 @@
         with the name of each file to download as an argument, expecting
         it to output the URL of the directory from which to download
         it. <filename role="pkg">graphics/ns-cult3d</filename> is an
-       example of this usage.
-</para>
+       example of this usage.</para>
 
        <para>If the download can't be automated, because the user must
        submit personal information to apply for a password, or must pay