From owner-freebsd-doc  Sat Jul 15  9:20:15 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 04AAC37C45A
	for <freebsd-doc@freebsd.org>; Sat, 15 Jul 2000 09:20:02 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id JAA56815;
	Sat, 15 Jul 2000 09:20:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 68C1337B749; Sat, 15 Jul 2000 09:13:47 -0700 (PDT)
Message-Id: <20000715161347.68C1337B749@hub.freebsd.org>
Date: Sat, 15 Jul 2000 09:13:47 -0700 (PDT)
From: ushida@msa.biglobe.ne.jp
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/19949: The description of /usr/share/examples/cvsup/refuse is inconsistent with cvsup(1).
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         19949
>Category:       docs
>Synopsis:       The description of /usr/share/examples/cvsup/refuse is inconsistent with cvsup(1).
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jul 15 09:20:01 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Jun Ushida
>Release:        4.1-RC
>Organization:
secret!!
>Environment:
FreeBSD olive.localdomain 4.1-RC FreeBSD 4.1-RC #0: Sat Jul 15 08:35:55 JST 2000     root@olive.localdomain:/usr1/obj/usr1/src/sys/WAKANA  i386

>Description:
An error in writing of the explanation in /usr/share/examples/cvsup/refuse
causes misinterpretation and inconsistency with cvsup(1).
Although cvsup(1) says `There is currently no provision for comments 
in refuse files.', in /usr/share/examples/cvsup/refuse:
#You can copy this file to your sup directory and uncomment or add
#whatever you would like.

I propose to change the above two lines in /usr/share/examples/cvsup/refuse to:

#You can copy this file to your sup directory and uncomment or add
#whatever you would like. It should be noted that any comment must be 
#removed from refuse files as there is currently no provision for comments.

or add the following lines to /usr/share/examples/cvsup/refuse.
#----------------------------------------------------------------------------
#CAUTION:Any comment must be removed from refuse files as there is currently 
#        no provision for comments.
#----------------------------------------------------------------------------

If there are comments in /usr/sup/refuse by mistake caused by the explanation
in /usr/share/examples/cvsup/refuse, the behavior of `cvsup' depends strongly 
on the server-defined collection of files and even on the comments. 
This is the cause of the delayed finding of this problem. For example,
1. If one uses the whole /usr/share/examples/cvsup/refuse as /usr/sup/refuse,
   cvsup works for `ports-all' and donsn't work for 'src-all'(no error but 
   never update).
2. If one uses the modified /usr/share/examples/cvsup/refuse where the second
   line from the end of the file 
   (#Use this feature with care -- many parts of the src distribution depend)
   are removed, cvsup works for `ports-all' and `src-all'.

Best regards,

Jun Ushida
>How-To-Repeat:
Uses the whole /usr/share/examples/cvsup/refuse as /usr/sup/refuse.
The command `cvsup' works for `ports-all' and donsn't work for 
'src-all'(no error but never update).

>Fix:
Modify /usr/share/examples/cvsup/refuse as I proposed.


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


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