From nobody@FreeBSD.org  Fri Feb 17 19:18:45 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 0DB73106566C
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <slasiewski@lbl.gov>
To: freebsd-gnats-submit@FreeBSD.org
Subject: "5.5.4.3 Upgrading Ports using Portmanager" should be clearer about flags
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>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:    bcr
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Feb 17 19:20:17 UTC 2012
>Closed-Date:    Mon Feb 20 19:22:40 UTC 2012
>Last-Modified:  Mon Feb 20 19:22:40 UTC 2012
>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:

From: Isabell Long <isabell121@gmail.com>
To: Stefan Lasiewski <slasiewski@lbl.gov>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/165250: "5.5.4.3 Upgrading Ports using Portmanager"
 should be clearer about flags
Date: Sun, 19 Feb 2012 20:05:21 +0000

 --wac7ysb48OaltWcw
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hi,
 
 On Fri, Feb 17, 2012 at 07:18:44PM +0000, Stefan Lasiewski wrote:
 
 [...]
 
 > Can you please make the documentation clearly state that the proper flags should be `-u -ui` and not `-ui`.
 
 Thanks for the report - attached is a patch.
 
 Isabell.
 
 --wac7ysb48OaltWcw
 Content-Type: text/x-diff; charset=us-ascii
 Content-Disposition: attachment; filename="portmanager.diff"
 
 Index: chapter.sgml
 ===================================================================
 RCS file: /home/isabell/freebsd/doc-cvs/doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml,v
 retrieving revision 1.296
 diff -u -r1.296 chapter.sgml
 --- chapter.sgml	18 Feb 2012 05:33:47 -0000	1.296
 +++ chapter.sgml	19 Feb 2012 20:06:04 -0000
 @@ -1256,7 +1256,9 @@
  
  	<screen>&prompt.root; <userinput>portmanager -u</userinput></screen>
  
 -	<para>You can add the <option>-ui</option> flag to get asked for
 +	<para>You can add the <option>-ui</option> flag to the above
 +	  command (<userinput>portmanager -u -ui</userinput>) to be
 +	  prompted for
  	  confirmation of every step <application>Portmanager</application>
  	  will perform.  <application>Portmanager</application> can also be
  	  used to install new ports on the system.  Unlike the usual
 
 --wac7ysb48OaltWcw--
Responsible-Changed-From-To: freebsd-doc->bcr 
Responsible-Changed-By: bcr 
Responsible-Changed-When: Sun Feb 19 21:06:14 UTC 2012 
Responsible-Changed-Why:  
I will get this fixed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=165250 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/165250: commit references a PR
Date: Mon, 20 Feb 2012 19:09:48 +0000 (UTC)

 bcr         2012-02-20 19:09:35 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/ports chapter.sgml 
   Log:
   Clear up the description of the portmanager flags: it should be
   -u -ui rather than just -ui.
   
   PR:             docs/165250
   Submitted by:   Stefan Lasiewski (slasiewski lbl gov)
   Patch by:       Isabell Long (isabell121 gmail com)
   
   Revision  Changes    Path
   1.297     +3 -1      doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: bcr 
State-Changed-When: Mon Feb 20 19:19:38 UTC 2012 
State-Changed-Why:  
Patch was committed without modifications. Thanks for reporting this and 
providing the patch, respectively. Good teamwork! PR closed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=165250 
>Unformatted:
