From nobody@FreeBSD.org  Fri Mar 30 15:47:46 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 7E77C106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 30 Mar 2012 15:47:46 +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 465348FC1C
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 30 Mar 2012 15:47:46 +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 q2UFlk9B052070
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 30 Mar 2012 15:47:46 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q2UFlkeD052069;
	Fri, 30 Mar 2012 15:47:46 GMT
	(envelope-from nobody)
Message-Id: <201203301547.q2UFlkeD052069@red.freebsd.org>
Date: Fri, 30 Mar 2012 15:47:46 GMT
From: cody chandler <cody.a.chandler@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: 5.5 of hand book  "provide basic instructions on using the Ports Collection to install or remove programs"  I asked in channel which do I run first..  cvsup or portsnap and when do I delete ports since I used the dvd for install of 9.0.  Could tX-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         166521
>Category:       docs
>Synopsis:       [handbook] section 5.5 of handbook is confusing
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 30 15:50:12 UTC 2012
>Closed-Date:    Sat Apr 28 22:31:01 UTC 2012
>Last-Modified:  Sat Apr 28 22:31:01 UTC 2012
>Originator:     cody chandler
>Release:        9.0 release
>Organization:
none
>Environment:
$ uname -a
FreeBSD backroom.tvworldwide.com 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Tue Jan  3 07:15:25 UTC 2012     root@obrian.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386

>Description:
The way the writing is in the hand book.  Please note my reading skills are not as good as most.  I have dislexia and tend to read something and mix it up or not comprehend it until I do read something several times.  I read the HandBook 4 times and reinstalled and deleted /usr/ports 8 times testing to see what the difference was with cvsup and portsnap.
>How-To-Repeat:

>Fix:
  Could
  there be a line added to 5.5 saying there are different steps to fetching and installing.  Point out that cvsup 5.5.1 "Make sure /usr/ports is empty before you run csup for the first time! If you already have the Ports Collection present, obtained from  another source, csup will not prune removed patch files."  That line is what confused me to think I wasted time using ports from the DVD. When I only needed portsnap to update to stable.  Thank you!

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-ports-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Mon Apr 2 06:29:52 UTC 2012 
Responsible-Changed-Why:  
this is more a question about the handbook. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=166521 
State-Changed-From-To: open->closed 
State-Changed-By: gjb 
State-Changed-When: Sat Apr 28 22:27:39 UTC 2012 
State-Changed-Why:  
Following the 'CVSup Method' in the Handbook is documentation concerning 
using portsnap to keep your Ports tree up-to-date. 

In the PR, it is mentioned that the originator "only needed to use portsnap." 

As both CVSup/csup and Portsnap are documented, I don't see how it can be made 
more clear that one or the other is used. 

However, if a suggestion is made on what the text should state to make this 
differentiation more clear, I will be happy to reopen this PR. 

Glen 



Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Sat Apr 28 22:27:39 UTC 2012 
Responsible-Changed-Why:  
Track. 


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