Bug 23496

Summary:	cvsup documentation inconsistent about the default value for base
Product:	Documentation	Reporter:	bkogawa <bkogawa>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description bkogawa 2000-12-12 08:40:01 UTC

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).

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.
How-To-Repeat: 
See above web page

Comment 1 bkogawa 2000-12-12 11:18:54 UTC

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

Comment 2 ben freebsd_committer

2000-12-12 13:41:11 UTC

State Changed
From-To: open->closed

Committed, thanks!