Bug 17972

Summary: FreeBSD has no example refuse supfile
Product: Documentation Reporter: Michael W Lucas <mwlucas>
Component: Books & ArticlesAssignee: Sheldon Hearn <sheldonh>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Michael W Lucas 2000-04-13 14:50:02 UTC
People don't understand how to make CVSup refuse to update certain
files.  This pops up on -questions and -stable repeatedly.

Fix: 

Here is my suggested file: /usr/share/examples/cvsup/refuse

#This is an example "refuse file".  You can copy this file to
#/usr/sup/refuse and uncomment what you want.
#
#Any file listed in /usr/sup/refuse will not be touched by cvsup.  For
#example, if you've modified /usr/src/etc/sendmail/freebsd.mc to
#reflect your local configuration, and you don't CVSup to touch that
#file, you can uncomment this:
#
#etc/sendmail/freebsd.mc
#
#If you list a directory, changes to any files beneath that directory
#will be rejected.  For example, if you are an English speaker and are
#not tracking the foreign-language ports, you can uncomment the following.
#
#ports/chinese
#ports/german
#ports/japanese
#ports/korean
#ports/russian
#ports/vietnamese
#
#If you refuse large sections of the system (for example, bin/), make
#world might refuse to work properly.
How-To-Repeat: 
ls /usr/share/examples/cvsup/
Comment 1 Sheldon Hearn 2000-04-13 14:55:14 UTC
On Thu, 13 Apr 2000 09:47:57 -0400, mwlucas@blackhelicopters.org wrote:

> People don't understand how to make CVSup refuse to update certain
> files.  This pops up on -questions and -stable repeatedly.

Excellent!  The only thing I think we could do to improve on what you've
sent is clarify that /usr/sup depends on ``base=/usr'' in the supfile.

Ciao,
Sheldon.
Comment 2 Michael W Lucas 2000-04-13 15:23:17 UTC
> On Thu, 13 Apr 2000 10:03:38 -0400, Michael Lucas wrote:
> 
> > Sure, should I send it to you or re-pr?
> 
> Send it to me, cc freebsd-gnats-submit@freebsd.org, maintaining the
> subject line. :-)

Done.  Now will you make those people on -stable go away?  ;)

#This is an example "refuse file".  You can copy this file to your sup
#directory and uncomment what you want.
#
#If you've taken the defaults, your sup directory is /usr/sup.  If
#you've changed your base directory, your sup directory is $BASE/sup.
#
#CVSup will not touch anything listed in the refuse file.  
#
#For example, if you've modified /usr/src/etc/sendmail/freebsd.mc to
#reflect your local configuration, and you don't CVSup to touch that
#file, you can uncomment this:
#
#etc/sendmail/freebsd.mc
#
#If you list a directory, changes to any files beneath that directory
#will be rejected.  For example, if you are an English speaker and are
#not tracking the foreign-language ports, you can uncomment the following.
#
#ports/chinese
#ports/german
#ports/japanese
#ports/korean
#ports/russian
#ports/vietnamese
#
#If you refuse large sections of the system (for example, bin/), make
#world might refuse to work properly.
Comment 3 Sheldon Hearn freebsd_committer freebsd_triage 2000-04-13 15:37:00 UTC
Responsible Changed
From-To: freebsd-doc->sheldonh

Excellent.  I'll take this one. 
Comment 4 Sheldon Hearn freebsd_committer freebsd_triage 2000-04-13 15:43:27 UTC
State Changed
From-To: open->closed

Committed and merged onto the RELENG_4 and RELENG_3 branches. 
Thanks!