Skip site navigation (1)Skip section navigation (2)
Date:      Sat,  8 Mar 2003 16:53:32 +0100 (CET)
From:      "Simon L.Nielsen" <simon@nitro.dk>
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/49032: [patch] Error in handbook/current-stable
Message-ID:  <20030308155332.938F810BF84@arthur.nitro.dk>

next in thread | raw e-mail | index | archive | help

>Number:         49032
>Category:       docs
>Synopsis:       [patch] Error in handbook/current-stable
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 08 08:00:27 PST 2003
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030308155332.938F810BF84>