From nobody@FreeBSD.org  Wed Jan  2 06:33:53 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 26E4C21C
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  2 Jan 2013 06:33:53 +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 0EC1A8FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  2 Jan 2013 06:33:53 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id r026XqZg047721
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 2 Jan 2013 06:33:52 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id r026Xqu7047720;
	Wed, 2 Jan 2013 06:33:52 GMT
	(envelope-from nobody)
Message-Id: <201301020633.r026Xqu7047720@red.freebsd.org>
Date: Wed, 2 Jan 2013 06:33:52 GMT
From: Ivar Castro <ivar123@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: 5.6.1 of handbook has a small problem
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         174892
>Category:       docs
>Synopsis:       [handbook] 5.6.1 of handbook has a small problem
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jan 02 06:40:00 UTC 2013
>Closed-Date:    Mon Mar 04 20:01:29 UTC 2013
>Last-Modified:  Mon Mar 04 20:01:29 UTC 2013
>Originator:     Ivar Castro
>Release:        9.0
>Organization:
>Environment:
Does not apply.
>Description:
The following part of 5.6.1 in the handbook is somewhat misleading:

After the first use of Portsnap has been completed as shown above, /usr/ports can be updated with:

# portsnap update


Users get the impression that:

# portsnap fetch 

only has to be done once, ever. 

Considering that a user who has already used Portsnap for the first time will not want to update the compressed snapshot of the Ports Collection he has already extracted. He will need to fetch a new snapshot when he wants to update the Ports Collection.
>How-To-Repeat:

>Fix:
To fix this problem I suggest we change said part to:

After the first use of Portsnap has been completed as shown above, /usr/ports can be updated with:

# portsnap fetch
# portsnap update

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Wed Feb 27 21:53:00 UTC 2013 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=174892 
State-Changed-From-To: open->analyzed 
State-Changed-By: eadler 
State-Changed-When: Wed Feb 27 22:10:00 UTC 2013 
State-Changed-Why:  
awaiting approval or review prior to commit (no action needed from 
submitter) 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/174892: commit references a PR
Date: Mon,  4 Mar 2013 19:16:19 +0000 (UTC)

 Author: eadler
 Date: Mon Mar  4 19:16:11 2013
 New Revision: 41091
 URL: http://svnweb.freebsd.org/changeset/doc/41091
 
 Log:
   Make it more obvious that 'portsnap fetch' is required for updating
   ports, not just on first run.
   
   PR:		docs/174892
   Submitted by:	Ivar Castro <ivar123@gmail.com>
   Reviewed by:	crees
   Approved by:	bcr (mentor)
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Mon Mar  4 19:16:04 2013	(r41090)
 +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Mon Mar  4 19:16:11 2013	(r41091)
 @@ -1017,14 +1017,17 @@ Deinstalling ca_root_nss-3.13.5... done<
  	    <filename class="directory">/usr/ports</filename>:</para>
  
  	  <screen>&prompt.root; <userinput>portsnap extract</userinput></screen>
 +	</step>
  
 +	<step>
  	  <para>After the first use of
  	    <application>Portsnap</application> has been completed as
  	    shown above,
  	    <filename class="directory">/usr/ports</filename> can be
  	    updated with:</para>
  
 -	  <screen>&prompt.root; <userinput>portsnap update</userinput></screen>
 +	  <screen>&prompt.root; <userinput>portsnap fetch</userinput>
 +&prompt.root; <userinput>portsnap update</userinput></screen>
  	</step>
        </procedure>
  
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: analyzed->closed 
State-Changed-By: eadler 
State-Changed-When: Mon Mar 4 20:01:29 UTC 2013 
State-Changed-Why:  
fixed in r41091 

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