From owner-freebsd-doc  Fri Jan 26 15: 0:20 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id CB2D637B69E
	for <freebsd-doc@freebsd.org>; Fri, 26 Jan 2001 15:00:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f0QN01d89510;
	Fri, 26 Jan 2001 15:00:01 -0800 (PST)
	(envelope-from gnats)
Received: from bartequi.ottodomain.org (unknown [62.98.162.85])
	by hub.freebsd.org (Postfix) with ESMTP id 61CA537B699
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 26 Jan 2001 14:50:14 -0800 (PST)
Received: (from otto@localhost)
	by bartequi.ottodomain.org (8.11.1/8.11.1) id f0QMqAq00482;
	Fri, 26 Jan 2001 23:52:10 +0100 (CET)
	(envelope-from otto)
Message-Id: <200101262252.f0QMqAq00482@bartequi.ottodomain.org>
Date: Fri, 26 Jan 2001 23:52:10 +0100 (CET)
From: bartequi@inwind.it
Reply-To: bartequi@inwind.it
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/24662: correct management of sources with cvsup(1)
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         24662
>Category:       docs
>Synopsis:       too many questions about source management bloat freebsd lists
>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:   Fri Jan 26 15:00:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Salvo Bartolotta
>Release:        FreeBSD 4.2-STABLE i386
>Organization:
>Environment:

	

>Description:
Stale files may cause users a number of problems. The role and 
importance of cvsup's checkouts file(s) seems to be widely ignored, as 
well the existence of such utilities as cvsupchk. 


>How-To-Repeat:

	
Read -questions for a while... 

>Fix:

	
Moooo! I have written far too many times to freebsd lists on the subject :-)

A reference to J.Polstra's cvsup FAQ should be made and/or emphasized in
the existing documentation (handbook and/or cvsup(1) and/or FreeBSD FAQ);
in this connection, explicit specific examples might be helpful.

Also, cvsupchk should be mentioned as a useful tool for correct source 
management. 



I wrote a few public letters, as well as several private ones covering 
the following topics:

--  correctly updating one's sources via cvsup for the first time;
--  switching one's sources from tag A to tag B;
--  correctly updating one's ports tree for the first time. 

If anybody is interested in this material, I will be glad to submit it 
for revision -- as plain text, for the time being.

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message