From owner-freebsd-doc@FreeBSD.ORG  Sat Nov 13 23:10:53 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id D5D5616A4CE; Sat, 13 Nov 2004 23:10:53 +0000 (GMT)
Received: from ns1.tiadon.com (SMTP.tiadon.com [69.27.132.161])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 87BCD43D3F; Sat, 13 Nov 2004 23:10:53 +0000 (GMT)
	(envelope-from kdk@daleco.biz)
Received: from [69.27.131.0] ([69.27.131.0]) by ns1.tiadon.com with Microsoft
	SMTPSVC(6.0.3790.211);	 Sat, 13 Nov 2004 17:07:18 -0600
Message-ID: <41969484.3010700@daleco.biz>
Date: Sat, 13 Nov 2004 17:11:00 -0600
From: "Kevin D. Kinsey, DaleCo, S.P." <kdk@daleco.biz>
User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.7.2) Gecko/20041023
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Pav Lucistnik <pav@freebsd.org>
References: <200411131802.iADI2ole012671@repoman.freebsd.org>
In-Reply-To: <200411131802.iADI2ole012671@repoman.freebsd.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-OriginalArrivalTime: 13 Nov 2004 23:07:18.0983 (UTC)
	FILETIME=[86319570:01C4C9D5]
cc: doc@freebsd.org
Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/mirrors
	chapter.sgml
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 13 Nov 2004 23:10:53 -0000

Pav Lucistnik wrote:

>pav         2004-11-13 18:02:50 UTC
>
>  FreeBSD doc repository (ports committer)
>
>  Modified files:
>    en_US.ISO8859-1/books/handbook/mirrors chapter.sgml 
>  Log:
>  - Remove a ports related section of CVSup refuse example. There are people
>    who blindly copy this example to their environment. These people end
>    with ports tree uncapable of building INDEX (some ports depend on ports
>    in japanese category, which is refused in this example).
>  
>    The remaining part of example still does a good job in demonstrating
>    CVSup refuse file syntax.
>  
>  Approved by:    simon (doc hat),
>                  linimon (portmgr hat)
>  
>  Revision  Changes    Path
>  1.366     +3 -17     doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml
>

Hmm, I was just helping a fellow on questions@ who had this problem on his
workstation.

It seems well to me (not that I matter much) to do this much; 
additionally, what about
the section in handbook Appendix A on CVSup (where the text is nearly 
identical,
though the example is not there)? 

Would it be a Good Thing(tm) to add a brief warning that you shouldn't 
expect to
refuse anything in the  ports tree and call 'make index' or 'portsdb 
-uU', etc.,
but you can fix the problem by "make fetchindex" if necessary . . .

I'll happily file a PR if it seems appropriate to do so to you 
'documitters' ...

Kevin Kinsey