CFD: minor patch to the Handbook (cvsup section)

Mark Linimon linimon at lonesome.com
Sun Dec 19 04:04:07 UTC 2004


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>



More information about the freebsd-doc mailing list