svn commit: r39468 - head/en_US.ISO8859-1/books/handbook/ports

[Isabell Long]

Author: issyl0
Date: Wed Aug 29 14:29:03 2012
New Revision: 39468
URL: http://svn.freebsd.org/changeset/doc/39468

Log:
  Add a note about make's config-recursive option to the ports chapter of
  the Handbook.
  
  PR:		docs/164826
  Approved by:	gjb (mentor)

Modified:
  head/en_US.ISO8859-1/books/handbook/ports/chapter.sgml

Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/ports/chapter.sgml	Wed Aug 29 05:59:54 2012	(r39467)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.sgml	Wed Aug 29 14:29:03 2012	(r39468)
@@ -976,6 +976,18 @@ docbook                     =
 	    <command>make <maketarget>install</maketarget></command> and
 	    <command>make <maketarget>clean</maketarget></command>
 	    as three separate steps.</para>
+
+	  <para>When installing a port, using only <command>make
+	      <maketarget>install</maketarget></command> from the
+	    beginning means there will potentially be many waiting
+	    periods between user interaction as the default behaviour
+	    is to prompt the user for options.  When there are many
+	    dependencies, this sometimes makes building a single port
+	    a huge hassle.  To avoid this, first run <command>make
+	      <maketarget>config-recursive</maketarget></command> to
+	    do the configuration in one batch.  Then run
+	    <command>make <maketarget>install
+	      [clean]</maketarget></command> afterwards.</para>
 	</note>
 
 	<note>