From bkogawa@baz.fake.primenet.com  Tue Dec 12 00:38:06 2000
Return-Path: <bkogawa@baz.fake.primenet.com>
Received: from baz.fake.primenet.com (unknown [209.237.31.190])
	by hub.freebsd.org (Postfix) with ESMTP id 8278437B402
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 12 Dec 2000 00:38:05 -0800 (PST)
Received: (from bkogawa@localhost)
	by baz.fake.primenet.com (8.9.3/8.9.3) id AAA75043;
	Tue, 12 Dec 2000 00:38:04 -0800 (PST)
	(envelope-from bkogawa)
Message-Id: <200012120838.AAA75043@baz.fake.primenet.com>
Date: Tue, 12 Dec 2000 00:38:04 -0800 (PST)
From: bkogawa@primenet.com
Sender: bkogawa@baz.fake.primenet.com
Reply-To: bkogawa@primenet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: cvsup documentation inconsistent about the default value for base
X-Send-Pr-Version: 3.2

>Number:         23496
>Category:       docs
>Synopsis:       cvsup documentation inconsistent about the default value for base
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 12 00:40:01 PST 2000
>Closed-Date:    Tue Dec 12 13:41:11 GMT 2000
>Last-Modified:  Tue Dec 12 13:41:24 GMT 2000
>Originator:     Bryan K. Ogawa
>Release:        FreeBSD 4.1-RELEASE i386
>Organization:
>Environment:

FreeBSD baz.fake.primenet.com 4.1-RELEASE FreeBSD 4.1-RELEASE #0: Sat Oct  7 22:49:51 PDT 2000     bkogawa@baz.fake.primenet.com:/usr/src/sys/compile/BAZAWE  i386


>Description:

the documentation at

http://www.freebsd.org/handbook/cvsup.html

lists the default base value (if base is not in your cvsupfile) as
/usr/local/etc/cvsup in the section "Where should cvsup maintain its
status files?" This corresponds to the man page I have for

	Software version: REL_16_1
	Protocol version: 16.1

However, slightly later, in the section entitled 'The refuse file', it 
claims that the default value for base (if it is not defined for your
cvsupfile) is /usr/sup .  Also confusing here is that it claims that
the refuse file belongs in base/sup/refuse , while saying that a base
value of /usr/sup produces a refuse file result of /usr/sup/refuse
(while if base were actually /usr/sup, this should produce a refuse
file of /usr/sup/sup/refuse, i think).


>How-To-Repeat:

See above web page

>Fix:

Correct the conflicting defaults to base.  Since i was reading this
section in preparation for contributing to the doc project, I will try
to fix this if i can (a) verify what the current cvsup thinks that the
default value for base is, and (b) if i can check out the doc files
for editing.


>Release-Note:
>Audit-Trail:

From: "Bryan K. Ogawa" <bkogawa@primenet.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/23496: cvsup documentation inconsistent about the default
 value for base
Date: Tue, 12 Dec 2000 03:18:54 -0800 (PST)

 Here is a patch against the file in
 doc/en_US.ISO_8859-1/books/handbook/mirrors/chapter.sgml, which appears to
 be the file in question.  I'm not sure i did the right stuff, and i
 didn't try to recompile the sgml.  I did try to upgrade to the latest
 cvsup-bin, which said that the default for base was /usr/local/etc/cvsup .
 
 
 
 *** handbook/mirrors/chapter.sgml.orig	Tue Dec 12 03:10:30 2000
 --- handbook/mirrors/chapter.sgml	Tue Dec 12 03:11:34 2000
 ***************
 *** 2174,2181 ****
          <filename><replaceable>base</replaceable>/sup/refuse</filename>.
          <replaceable>base</replaceable> is defined in your supfile; by
          default, <replaceable>base</replaceable> is
 !        <filename>/usr/sup</filename>, which means that by default the
 !        refuse file is in <filename>/usr/sup/refuse</filename>.</para>
   
          <para>The refuse file has a very simple format; it simply
          contains the names of files or directories that you do not wish
 --- 2174,2183 ----
          <filename><replaceable>base</replaceable>/sup/refuse</filename>.
          <replaceable>base</replaceable> is defined in your supfile; by
          default, <replaceable>base</replaceable> is
 !        <filename>/usr/local/etc/cvsup</filename>, 
 !        which means that by default the
 !        refuse file is in 
 !        <filename>/usr/local/etc/cvsup/sup/refuse</filename>.</para>
   
          <para>The refuse file has a very simple format; it simply
          contains the names of files or directories that you do not wish
 
 
State-Changed-From-To: open->closed 
State-Changed-By: ben 
State-Changed-When: Tue Dec 12 13:41:11 GMT 2000 
State-Changed-Why:  
Committed, thanks! 

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