INTERACTIVE_STAGE should not be set to "fetch".

1 files changed, 12 insertions, 5 deletions

diff --git a/doc/guide/files/fixes.xml b/doc/guide/files/fixes.xml
index e9ff1bec29a..d803316cd07 100644
--- a/doc/guide/files/fixes.xml
+++ b/doc/guide/files/fixes.xml
@@ -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,8 +83,15 @@
 <programlisting>
     INTERACTIVE_STAGE=      configure install
 </programlisting>
-    </sect2>
 
+	<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 @@ Changes to the PLIST
         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