From owner-svn-doc-head@FreeBSD.ORG  Fri Aug 31 00:55:36 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 75246106566C;
	Fri, 31 Aug 2012 00:55:36 +0000 (UTC) (envelope-from gjb@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 601588FC08;
	Fri, 31 Aug 2012 00:55:36 +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 q7V0tZkL041417;
	Fri, 31 Aug 2012 00:55:35 GMT (envelope-from gjb@svn.freebsd.org)
Received: (from gjb@localhost)
	by svn.freebsd.org (8.14.4/8.14.4/Submit) id q7V0tZcq041415;
	Fri, 31 Aug 2012 00:55:35 GMT (envelope-from gjb@svn.freebsd.org)
Message-Id: <201208310055.q7V0tZcq041415@svn.freebsd.org>
From: Glen Barber <gjb@FreeBSD.org>
Date: Fri, 31 Aug 2012 00:55:35 +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: r39474 - 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: Fri, 31 Aug 2012 00:55:36 -0000

Author: gjb
Date: Fri Aug 31 00:55:35 2012
New Revision: 39474
URL: http://svn.freebsd.org/changeset/doc/39474

Log:
  - Separate a large <note> section into two.
  - Add a <tip>, mentioning it might be desired to run make(1) multiple
    times when using the 'configure-recursive' target. [1]
  
  Suggested by:	bjk [1]

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	Thu Aug 30 19:48:29 2012	(r39473)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.sgml	Fri Aug 31 00:55:35 2012	(r39474)
@@ -976,7 +976,9 @@ docbook                     =
 	    <command>make <maketarget>install</maketarget></command> and
 	    <command>make <maketarget>clean</maketarget></command>
 	    as three separate steps.</para>
+	</note>
 
+	<note>
 	  <para>When installing a port, using only <command>make
 	      <maketarget>install</maketarget></command> from the
 	    beginning means there will potentially be many waiting
@@ -990,6 +992,18 @@ docbook                     =
 	      [clean]</maketarget></command> afterwards.</para>
 	</note>
 
+	<tip>
+	  <para>When using <maketarget>config-recursive</maketarget>,
+	    the list of ports to configure are gathered by the
+	    <maketarget>all-depends-list</maketarget> &man.make.1;
+	    target.  It is often recommended to run <command>make
+	      <maketarget>config-recursive</maketarget></command>
+	    until all dependent ports options have been defined, and
+	    ports options &man.dialog.1; screens no longer
+	    appear, to be certain all ports options have been
+	    configured as intended.</para>
+	</tip>
+
 	<note>
 	  <para>Some shells keep a cache of the commands that are
 	    available in the directories listed in the