From owner-svn-doc-head@FreeBSD.ORG  Wed Aug 29 14:29:03 2012
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id C5F67106566C;
	Wed, 29 Aug 2012 14:29:03 +0000 (UTC)
	(envelope-from issyl0@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id B12A78FC12;
	Wed, 29 Aug 2012 14:29:03 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q7TET39q060723;
	Wed, 29 Aug 2012 14:29:03 GMT (envelope-from issyl0@svn.freebsd.org)
Received: (from issyl0@localhost)
	by svn.freebsd.org (8.14.4/8.14.4/Submit) id q7TET3kL060721;
	Wed, 29 Aug 2012 14:29:03 GMT (envelope-from issyl0@svn.freebsd.org)
Message-Id: <201208291429.q7TET3kL060721@svn.freebsd.org>
From: Isabell Long <issyl0@FreeBSD.org>
Date: Wed, 29 Aug 2012 14:29:03 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
	svn-doc-head@freebsd.org
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r39468 - head/en_US.ISO8859-1/books/handbook/ports
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: SVN commit messages for the doc tree for head
	<svn-doc-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
	<mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
	<mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 29 Aug 2012 14:29:03 -0000

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>