From owner-freebsd-doc@FreeBSD.ORG  Thu Oct  4 00:00:25 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 02E81106566B
	for <freebsd-doc@hub.freebsd.org>; Thu,  4 Oct 2012 00:00:24 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id C25DF8FC0A
	for <freebsd-doc@hub.freebsd.org>; Thu,  4 Oct 2012 00:00:24 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q9400ODV040965
	for <freebsd-doc@freefall.freebsd.org>; Thu, 4 Oct 2012 00:00:24 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q9400Ooo040963;
	Thu, 4 Oct 2012 00:00:24 GMT (envelope-from gnats)
Resent-Date: Thu, 4 Oct 2012 00:00:24 GMT
Resent-Message-Id: <201210040000.q9400Ooo040963@freefall.freebsd.org>
Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer)
Resent-To: freebsd-doc@FreeBSD.org
Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org,
	"Ronald F.Guilmette" <rfg@tristatelogic.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 39D141065704
	for <FreeBSD-gnats-submit@freebsd.org>;
	Wed,  3 Oct 2012 23:52:31 +0000 (UTC)
	(envelope-from rfg@tristatelogic.com)
Received: from outgoing.tristatelogic.com (segfault.tristatelogic.com
	[69.62.255.118])
	by mx1.freebsd.org (Postfix) with ESMTP id 18DEF8FC20
	for <FreeBSD-gnats-submit@freebsd.org>;
	Wed,  3 Oct 2012 23:52:30 +0000 (UTC)
Received: by segfault.tristatelogic.com (Postfix, from userid 1237)
	id 732595083F; Wed,  3 Oct 2012 16:47:06 -0700 (PDT)
Message-Id: <20121003234706.732595083F@segfault.tristatelogic.com>
Date: Wed,  3 Oct 2012 16:47:06 -0700 (PDT)
From: "Ronald F.Guilmette" <rfg@tristatelogic.com>
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Cc: rfg@tristatelogic.com
Subject: docs/172313: man page for portupgrade doesn't describe the effects
	of --batch
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: "Ronald F.Guilmette" <rfg@tristatelogic.com>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 04 Oct 2012 00:00:25 -0000


>Number:         172313
>Category:       docs
>Synopsis:       man page for portupgrade doesn't describe the effects of --batch
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 04 00:00:24 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 8.3-RELEASE amd64
>Organization:
entr0py
>Environment:
System: 8.3-RELEASE

>Description:

The man page for portupgrade fails to describe the actual effects of --batch

>How-To-Repeat:

man portupgrade

>Fix:

Insert something like the following (which I found online):

The effect is that no configuration menus will pop up and require user intervention. The ports being upgraded will either use their default configuration options, or the ones previously saved during make config
>Release-Note:
>Audit-Trail:
>Unformatted: