From simon@arthur.nitro.dk  Sat Mar  8 07:53:36 2003
Return-Path: <simon@arthur.nitro.dk>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id DB3D437B405
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  8 Mar 2003 07:53:35 -0800 (PST)
Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 62BCD43F75
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  8 Mar 2003 07:53:34 -0800 (PST)
	(envelope-from simon@arthur.nitro.dk)
Received: by arthur.nitro.dk (Postfix, from userid 1000)
	id 938F810BF84; Sat,  8 Mar 2003 16:53:32 +0100 (CET)
Message-Id: <20030308155332.938F810BF84@arthur.nitro.dk>
Date: Sat,  8 Mar 2003 16:53:32 +0100 (CET)
From: Simon L.Nielsen <simon@nitro.dk>
Reply-To: Simon L.Nielsen <simon@nitro.dk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Error in handbook/current-stable
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         49032
>Category:       docs
>Synopsis:       [patch] Error in handbook/current-stable
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 08 08:00:27 PST 2003
>Closed-Date:    Sun Mar 09 23:14:52 PST 2003
>Last-Modified:  Sun Mar 09 23:14:52 PST 2003
>Originator:     Simon L. Nielsen
>Release:        FreeBSD 4.8-RC i386
>Organization:
>Environment:
>Description:
In the FreeBSD handbook chapter "21.2 FreeBSD-CURRENT vs. FreeBSD-STABLE"
there are links to ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/
and ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable/ which does not
exist anymore on ftp.freebsd.org (other mirrors does have them).

This is the same issue as I noted in the message
http://docs.freebsd.org/cgi/getmsg.cgi?fetch=10651+0+archive/2003/freebsd-doc/20030302.freebsd-doc
on freebsd-doc.
>How-To-Repeat:
>Fix:
--- doc-cutting-edge.patch begins here ---
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v
retrieving revision 1.180
diff -u -d -r1.180 chapter.sgml
--- chapter.sgml	14 Feb 2003 01:07:52 -0000	1.180
+++ chapter.sgml	8 Mar 2003 15:41:38 -0000
@@ -221,9 +221,8 @@
 	  </listitem>
 
 	  <listitem>
-	    <para>Grab the sources from <hostid
-	      role="fqdn">ftp.FreeBSD.org</hostid>.  You can do this in
-	      one of three ways:</para>
+	    <para>Grab the sources from a &os; <link linkend="mirrors">mirror
+	      site</link>.  You can do this in one of three ways:</para>
 
 	    <orderedlist>
               <indexterm>
@@ -262,9 +261,9 @@
 
 	      <listitem>
 		<para>Use <command>ftp</command>.  The source tree for
-		  &os.current; is always <quote>exported</quote> on:
-		  <ulink
-		  url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/">ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/</ulink>.
+		  &os.current; is <quote>exported</quote> on some of the
+		  <link linkend="mirrors-ftp">FTP mirrors</link> in the
+		  directory <filename>/pub/FreeBSD/FreeBSD-current/</filename>.
 		  Some of our FTP mirrors may also allow
 		  compressed/tarred grabbing of whole trees.  For example you
 		  see:</para>
@@ -276,6 +275,12 @@
 
 		<screen><prompt>ftp&gt;</prompt> <userinput>cd usr.bin</userinput>
 <prompt>ftp&gt;</prompt> <userinput>get lex.tar</userinput></screen>
+
+		<note>
+		  <para>If you wish to download the entire &os.current; source
+		    tree <command>cvsup</command> handles this much better than
+		    mirroring a FTP site.</para>
+		</note>
 	      </listitem>
 
               <indexterm>
@@ -436,7 +441,7 @@
 
 	    <para>If you are already running a previous release of &os;
 	      and wish to upgrade via sources then you can easily do so
-	      from <hostid role="fqdn">ftp.FreeBSD.org</hostid>.  This can
+	      from &os; <link linkend="mirrors">mirror site</link>.  This can
 	      be done in one of three ways:</para>
 
 	    <orderedlist>
@@ -474,9 +479,10 @@
 	      </indexterm>
 	      <listitem>
 		<para>Use <command>ftp</command>.  The source tree for
-		  &os.stable; is always <quote>exported</quote> on:
-		  <ulink
-		  url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable/">ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-stable/</ulink>.</para>
+		  &os.stable; is <quote>exported</quote> on some of the
+		  <link linkend="mirrors-ftp">FTP mirrors</link> in the
+		  directory <filename>/pub/FreeBSD/FreeBSD-stable/</filename>.
+		</para>
 
 		<para>Some of our FTP mirrors may also allow
 		  compressed/tarred grabbing of whole trees.  For example you
@@ -489,6 +495,12 @@
 
 		<screen><prompt>ftp&gt;</prompt> <userinput>cd usr.bin</userinput>
 <prompt>ftp&gt;</prompt> <userinput>get lex.tar</userinput></screen>
+
+		<note>
+		  <para>If you wish to download the entire &os.stable; source
+		    tree <command>cvsup</command> handles this much better than
+		    mirroring a FTP site.</para>
+		</note>
 	      </listitem>
 	      <indexterm>
 	        <primary>-STABLE</primary>
--- doc-cutting-edge.patch ends here ---
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Sun Mar 9 23:14:34 PST 2003 
State-Changed-Why:  
Committed with minor changes.  Thanks! 


http://www.freebsd.org/cgi/query-pr.cgi?pr=49032 
>Unformatted:
