From owner-svn-src-user@FreeBSD.ORG  Sun Jan 16 23:49:19 2011
Return-Path: <owner-svn-src-user@FreeBSD.ORG>
Delivered-To: svn-src-user@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 55C5F106564A;
	Sun, 16 Jan 2011 23:49:19 +0000 (UTC)
	(envelope-from dougb@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 45DFC8FC0A;
	Sun, 16 Jan 2011 23:49:19 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id p0GNnJsl081335;
	Sun, 16 Jan 2011 23:49:19 GMT (envelope-from dougb@svn.freebsd.org)
Received: (from dougb@localhost)
	by svn.freebsd.org (8.14.3/8.14.3/Submit) id p0GNnJAS081333;
	Sun, 16 Jan 2011 23:49:19 GMT (envelope-from dougb@svn.freebsd.org)
Message-Id: <201101162349.p0GNnJAS081333@svn.freebsd.org>
From: Doug Barton <dougb@FreeBSD.org>
Date: Sun, 16 Jan 2011 23:49:19 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-user@freebsd.org
X-SVN-Group: user
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r217490 - user/dougb/portmaster/files
X-BeenThere: svn-src-user@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the experimental &quot; user&quot;
	src tree" <svn-src-user.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-user>,
	<mailto:svn-src-user-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-user>
List-Post: <mailto:svn-src-user@freebsd.org>
List-Help: <mailto:svn-src-user-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-user>,
	<mailto:svn-src-user-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 16 Jan 2011 23:49:19 -0000

Author: dougb
Date: Sun Jan 16 23:49:19 2011
New Revision: 217490
URL: http://svn.freebsd.org/changeset/base/217490

Log:
  Clarify that -r builds the list of dependent ports by origin so it's
  safe to use -R with the new portname.

Modified:
  user/dougb/portmaster/files/portmaster.8

Modified: user/dougb/portmaster/files/portmaster.8
==============================================================================
--- user/dougb/portmaster/files/portmaster.8	Sun Jan 16 23:41:40 2011	(r217489)
+++ user/dougb/portmaster/files/portmaster.8	Sun Jan 16 23:49:19 2011	(r217490)
@@ -444,7 +444,19 @@ show what dependent ports are, and are n
 .It Fl o Ar <new port dir in /usr/ports> <installed port>
 replace the installed port with a port from a different origin
 .It [-R] Fl r Ar name/glob of port directory in /var/db/pkg
-rebuild the specified port, and all ports that depend on it
+rebuild the specified port, and all ports that depend on it.
+The list of dependent ports is built according to origin (i.e.,
+.Pa category/portname )
+not by the version number of the installed port.
+So if you do
+.Nm
+.Fl r Ar fooport-1.23
+and it is necessary to restart using
+.Fl R
+but the newly installed port is now fooport-1.24 you can do
+.Nm
+.Fl R Fl r Ar fooport-1.24
+and it should pick up where you left off.
 .It Fl R
 used with the
 .Fl r