svn commit: r217490 - user/dougb/portmaster/files

[Doug Barton]

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