From owner-freebsd-doc@FreeBSD.ORG Fri Feb 17 19:20:18 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 48A36106567B for ; Fri, 17 Feb 2012 19:20:18 +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 218F98FC14 for ; Fri, 17 Feb 2012 19:20:18 +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 q1HJKI27065586 for ; Fri, 17 Feb 2012 19:20:18 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q1HJKIdT065585; Fri, 17 Feb 2012 19:20:18 GMT (envelope-from gnats) Resent-Date: Fri, 17 Feb 2012 19:20:18 GMT Resent-Message-Id: <201202171920.q1HJKIdT065585@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, Stefan Lasiewski Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0DB73106566C for ; Fri, 17 Feb 2012 19:18:45 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id ED5078FC13 for ; Fri, 17 Feb 2012 19:18:44 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q1HJIim6086980 for ; Fri, 17 Feb 2012 19:18:44 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q1HJIiN2086979; Fri, 17 Feb 2012 19:18:44 GMT (envelope-from nobody) Message-Id: <201202171918.q1HJIiN2086979@red.freebsd.org> Date: Fri, 17 Feb 2012 19:18:44 GMT From: Stefan Lasiewski To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/165250: "5.5.4.3 Upgrading Ports using Portmanager" should be clearer about flags X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 Feb 2012 19:20:18 -0000 >Number: 165250 >Category: docs >Synopsis: "5.5.4.3 Upgrading Ports using Portmanager" should be clearer about flags >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Fri Feb 17 19:20:17 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Stefan Lasiewski >Release: freebsd-8.2 >Organization: LBNL >Environment: FreeBSD host.example.gov 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Thu Feb 17 02:41:51 UTC 2011 root@mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64 >Description: The documentation at http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html#PORTMANAGER says the following: "All the installed ports can be upgraded using this simple command: # portmanager -u You can add the -ui flag to get asked for confirmation of every step Portmanager will perform." This documentation is a bit vague and seems to be implying that I can try `portmanager -ui`. However, that returns an error: # portmanager -ui rParseCommandLine 0.4.1_9 error: /usr/ports/-ui is not a valid port directory rParseCommandLine 0.4.1_9 info:either you have used an invalid command line switch as the first option or you are trying to update a non existent port path, see man portmanager(1) MGPMrCommandLine 0.4.1_9 error: rParseCommandLine returned errorCode 1 The correct flags are `portmanager -u -ui`: # portmanager -u -ui ------------------------------------------------------------------------ portmanager 0.4.1_9: Collecting installed port data ------------------------------------------------------------------------ ... >How-To-Repeat: >Fix: Can you please make the documentation clearly state that the proper flags should be `-u -ui` and not `-ui`. Perhaps the following is more clear: Old: "You can add the -ui flag to get asked for confirmation of every step Portmanager will perform." New: "You can add the -ui ('portmanager -u -ui')flag to get asked for confirmation of every step Portmanager will perform." >Release-Note: >Audit-Trail: >Unformatted: