From owner-freebsd-doc@FreeBSD.ORG  Sun Dec 19 04:04:07 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 9836316A4D0; Sun, 19 Dec 2004 04:04:05 +0000 (GMT)
Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 5F30443D54; Sun, 19 Dec 2004 04:04:05 +0000 (GMT)
	(envelope-from linimon@lonesome.com)
Received: by mail.soaustin.net (Postfix, from userid 502)
	id E35A7148F2; Sat, 18 Dec 2004 22:04:04 -0600 (CST)
Date: Sat, 18 Dec 2004 22:04:04 -0600 (CST)
From: Mark Linimon <linimon@lonesome.com>
X-X-Sender: linimon@pancho
To: freebsd-doc@FreeBSD.org
Message-ID: <Pine.LNX.4.44.0412182157230.18236-100000@pancho>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
cc: brueffer@FreeBSD.org
Subject: CFD: minor patch to the Handbook (cvsup section)
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: Sun, 19 Dec 2004 04:04:07 -0000

brueffer asked me whether or not two of the descriptions of the ports
sub-collections were broken (they were).  I don't know if there is a
patch in flight to fix that or not ... but even if there isn't, the
far more glaring problem is that this is Yet Another Place that discusses
the idea that you can refuse parts of the ports collection but doesn't
mention that that's not an option if you want to build INDEX.  That's
gotta be added.  But:

1. I don't know if I got the crossref right;

2. I would accept the argument that it's dumb for the Handbook to
   reference the FAQ here instead of vice-versa.  (Although this
   location isn't really the right place for the text about INDEX.
   Right now, there really isn't such a place.)

3. I don't know if the below will step on anyone else's changes.

So, I'd appreciate review before commit.

mcl

Index: mirrors/chapter.sgml
===================================================================
RCS file: /home/FreeBSD/dcvs/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml,v
retrieving revision 1.368
diff -u -r1.368 chapter.sgml
--- mirrors/chapter.sgml	27 Nov 2004 21:34:50 -0000	1.368
+++ mirrors/chapter.sgml	19 Dec 2004 03:43:29 -0000
@@ -1448,6 +1448,17 @@
 		      date.</para>
 		  </important>
 
+		  <important id="cvsup-collec-index-warn">
+		    <para>If you are going to be building your own local
+		      copy of <filename>ports/INDEX</filename>, you
+		      <emphasis>must</emphasis> accept 
+		      <literal>ports-all</literal> (the whole ports tree).
+		      Building <filename>ports/INDEX</filename> with
+		      a partial tree is not supported.  See the
+		      <ulink url="&url.base;/books/faq/#make-index">
+		      FAQ</ulink>.</para>
+		  </important>
+
 		  <variablelist>
 		    <varlistentry>
 		      <term><literal>ports-archivers
@@ -1919,7 +1930,8 @@
 		    </varlistentry>
 
 		    <varlistentry>
-		      <term><literal>ports-x11-servers</literal></term>
+		      <term><literal>ports-x11-servers
+			  release=cvs</literal></term>
 		      
 		      <listitem>
 			<para>X11 servers.</para>
@@ -1927,7 +1939,8 @@
 		    </varlistentry>
 
 		    <varlistentry>
-		      <term><literal>ports-x11-wm</literal></term>
+		      <term><literal>ports-x11-wm
+			  release=cvs</literal></term>
 		      
 		      <listitem>
 			<para>X11 window managers.</para>