From owner-svn-src-user@FreeBSD.ORG  Sat May  1 02:53:44 2010
Return-Path: <owner-svn-src-user@FreeBSD.ORG>
Delivered-To: svn-src-user@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 231C01065672;
	Sat,  1 May 2010 02:53:44 +0000 (UTC)
	(envelope-from dougb@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [69.147.83.44])
	by mx1.freebsd.org (Postfix) with ESMTP id 13B428FC12;
	Sat,  1 May 2010 02:53:44 +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 o412rh7B056375;
	Sat, 1 May 2010 02:53:43 GMT (envelope-from dougb@svn.freebsd.org)
Received: (from dougb@localhost)
	by svn.freebsd.org (8.14.3/8.14.3/Submit) id o412rhE5056373;
	Sat, 1 May 2010 02:53:43 GMT (envelope-from dougb@svn.freebsd.org)
Message-Id: <201005010253.o412rhE5056373@svn.freebsd.org>
From: Doug Barton <dougb@FreeBSD.org>
Date: Sat, 1 May 2010 02:53:43 +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: r207459 - user/dougb/portmaster
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: Sat, 01 May 2010 02:53:44 -0000

Author: dougb
Date: Sat May  1 02:53:43 2010
New Revision: 207459
URL: http://svn.freebsd.org/changeset/base/207459

Log:
  Document the new working of the --index option, and the new --index-first

Modified:
  user/dougb/portmaster/portmaster.8

Modified: user/dougb/portmaster/portmaster.8
==============================================================================
--- user/dougb/portmaster/portmaster.8	Sat May  1 02:49:16 2010	(r207458)
+++ user/dougb/portmaster/portmaster.8	Sat May  1 02:53:43 2010	(r207459)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd April 9, 2010
+.Dd May 1, 2010
 .Dt PORTMASTER 8
 .Os
 .Sh NAME
@@ -41,7 +41,7 @@ Common Flags:
 .Op Fl -delete-packages
 .Op Fl -no-confirm
 .Op Fl -no-term-title
-.Op --index|--index-only
+.Op --index|--index-first|--index-only
 .Op Fl m Ar arguments for make
 .Op Fl x Ar glob pattern to exclude from building
 .Nm
@@ -433,7 +433,9 @@ be installed and/or updated before proce
 .It Fl -no-term-title
 do not update the xterm title bar
 .It Fl -index
-use INDEX-[6-9] to check if a port is out of date
+use INDEX-[6-9] exclusively to check if a port is up to date
+.It Fl -index-first
+use the INDEX for status, but double-check with the port
 .It Fl -index-only
 do not try to use
 .Pa /usr/ports .
@@ -658,9 +660,13 @@ along with their related options.
 # Do not update the xterm title bar (--no-term-title)
 # PM_NO_TERM_TITLE=pm_no_term_title
 #
-# Use the INDEX file to check if a port is out of date (--index)
+# Use only the INDEX file to check if a port is out of date (--index)
 # PM_INDEX=pm_index
 #
+# Use the INDEX file first, then check /usr/ports (--index-first)
+# PM_INDEX=pm_index
+# PM_INDEX_FIRST=pm_index_first
+#
 # Use the INDEX file instead of /usr/ports (--index-only)
 # PM_INDEX=pm_index
 # PM_INDEX_ONLY=pm_index_only