From owner-freebsd-doc@FreeBSD.ORG Thu Oct 4 00:00:25 2012 Return-Path: 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 BBCD31065670 for ; Thu, 4 Oct 2012 00:00:25 +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 75C118FC12 for ; Thu, 4 Oct 2012 00:00:25 +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 q9400Pbn040974 for ; Thu, 4 Oct 2012 00:00:25 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q9400PJh040973; Thu, 4 Oct 2012 00:00:25 GMT (envelope-from gnats) Resent-Date: Thu, 4 Oct 2012 00:00:25 GMT Resent-Message-Id: <201210040000.q9400PJh040973@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" Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id D7D9C1065678 for ; Wed, 3 Oct 2012 23:53:30 +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 B50458FC29 for ; Wed, 3 Oct 2012 23:53:30 +0000 (UTC) Received: by segfault.tristatelogic.com (Postfix, from userid 1237) id 2C09E5083F; Wed, 3 Oct 2012 16:53:30 -0700 (PDT) Message-Id: <20121003235330.2C09E5083F@segfault.tristatelogic.com> Date: Wed, 3 Oct 2012 16:53:30 -0700 (PDT) From: "Ronald F.Guilmette" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: rfg@tristatelogic.com Subject: docs/172314: man page for portupgrade doesn't specify upgrade ordering X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: "Ronald F.Guilmette" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 04 Oct 2012 00:00:25 -0000 >Number: 172314 >Category: docs >Synopsis: man page for portupgrade doesn't specify upgrade ordering >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 amd64 >Description: The man page for portupgrade fails to specify the ordering in which ports will be upgraded, e.g. when the -a option is used or whenever two or port ports are named on the command line. (Perhaps naively, I would _guess_ that portupgrade might be intelligent enough to order the set of ports it is asked to upgrade so that ports that are depended upon are upgraded _before_ the ports that depend on them. But is portupgrade _actually_ this intelligent? I hope so but I don't knwo and the man page does not appear to say.) >How-To-Repeat: man portupgrade >Fix: Document whatever ordering portupgrade imposes upon its work. If the order of port upgrading is determined merely alphabetically (in the case of -a) or based on the order in which ports to be upgraded are named on the command line, then the man page should say that. >Release-Note: >Audit-Trail: >Unformatted: