From kensmith@cse.Buffalo.EDU  Mon Jul 21 20:09:54 2003
Return-Path: <kensmith@cse.Buffalo.EDU>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4BB6037B401
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 21 Jul 2003 20:09:54 -0700 (PDT)
Received: from hobbes.cse.buffalo.edu (hobbes.cse.Buffalo.EDU [128.205.32.4])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 6D37243F85
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 21 Jul 2003 20:09:53 -0700 (PDT)
	(envelope-from kensmith@cse.Buffalo.EDU)
Received: from hobbes.cse.buffalo.edu (localhost.cse.buffalo.edu [127.0.0.1])
	by hobbes.cse.buffalo.edu (8.12.9/8.12.8) with ESMTP id h6M3DT9S093004;
	Mon, 21 Jul 2003 23:13:29 -0400 (EDT)
Received: (from kensmith@localhost)
	by hobbes.cse.buffalo.edu (8.12.9/8.12.9/Submit) id h6M3DSi8093003;
	Mon, 21 Jul 2003 23:13:28 -0400 (EDT)
Message-Id: <200307220313.h6M3DSi8093003@hobbes.cse.buffalo.edu>
Date: Mon, 21 Jul 2003 23:13:28 -0400 (EDT)
From: Ken Smith <kensmith@cse.Buffalo.EDU>
Reply-To: Ken Smith <kensmith@cse.Buffalo.EDU>
To: FreeBSD-gnats-submit@freebsd.org
Cc: kensmith@cse.Buffalo.EDU
Subject: Remove references to branches/ section of FTP site
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         54738
>Category:       docs
>Synopsis:       Remove references to branches/ section of FTP site
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 21 20:10:13 PDT 2003
>Closed-Date:    Tue Aug 05 18:31:11 PDT 2003
>Last-Modified:  Tue Aug 05 18:31:11 PDT 2003
>Originator:     Ken Smith
>Release:        FreeBSD 5.1-RELEASE i386
>Organization:
FreeBSD
>Environment:
System: FreeBSD hobbes.cse.buffalo.edu 5.1-RELEASE FreeBSD 5.1-RELEASE #2: Thu Jun 5 20:46:57 EDT 2003 root@hobbes.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386
>Description:
	We want to remove the branches/ section of the FTP site.  This
	patch, removes all references to that from the Handbook that I
	could find.
>How-To-Repeat:
	N/A
>Fix:

	Apply patch below in the main handbook/ directory please.  Thanks!

--- cutting-edge/chapter.sgml.orig	Thu Jul 17 10:50:12 2003
+++ cutting-edge/chapter.sgml	Fri Jul 18 22:52:45 2003
@@ -213,7 +213,7 @@
 
 	  <listitem>
 	    <para>Grab the sources from a &os; <link linkend="mirrors">mirror
-	      site</link>.  You can do this in one of three ways:</para>
+	      site</link>.  You can do this in one of two ways:</para>
 
 	    <orderedlist>
               <indexterm>
@@ -229,9 +229,9 @@
 
 	      <listitem>
 		<para>Use the <link linkend="cvsup">cvsup</link> program
-		  with <ulink
-		  url="ftp://ftp.jp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/standard-supfile">this
-		  supfile</ulink>.  This is the most recommended
+                  with the supfile named <filename>standard-supfile</filename>
+                  available from <filename>/usr/share/examples/cvsup</filename>.
+		  This is the most recommended
 		  method, since it allows you to grab the entire
 		  collection once and then only what has changed from then
 		  on.  Many people run <command>cvsup</command> from 
@@ -245,34 +245,6 @@
  		<screen>&prompt.root; <userinput>pkg_add -f ftp://ftp.freebsd.org/pub/FreeBSD/ports/packages/All/cvsupit-3.1.tgz</userinput></screen>
 
 	      </listitem>
-              <indexterm>
-	        <primary>-CURRENT</primary>
-	        <secondary>Downloading with ftp</secondary>
-	      </indexterm>
-
-	      <listitem>
-		<para>Use <command>ftp</command>.  The source tree for
-		  &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>
-
-		<screen>usr.bin/lex</screen>
-
-		<para>You can do the following to get the whole directory
-		  as a tar file:</para>
-
-		<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>
 	        <primary>-CURRENT</primary>
@@ -424,7 +396,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 &os; <link linkend="mirrors">mirror site</link>.  This can
-	      be done in one of three ways:</para>
+	      be done in one of two ways:</para>
 
 	    <orderedlist>
 	      <indexterm>
@@ -439,9 +411,10 @@
 	      </indexterm>
 	      <listitem>
 		<para>Use the <link linkend="cvsup">cvsup</link> program
-		  with <ulink
-		  url="ftp://ftp.jp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/stable-supfile">this
-		  supfile</ulink>.  This is the most recommended
+                  with the supfile named <filename>stable-supfile</filename>
+                  from the directory
+                  <filename>/usr/share/examples/cvsup</filename>.
+		  This is the most recommended
 		  method, since it allows you to grab the entire
 		  collection once and then only what has changed from then
 		  on.  Many people run <command>cvsup</command> from 
@@ -455,33 +428,6 @@
 		<blockquote><screen>&prompt.root; <userinput>pkg_add -f ftp://ftp.freebsd.org/pub/FreeBSD/ports/packages/All/cvsupit-3.1.tgz</userinput></screen></blockquote>
 	      </listitem>
 
-	      <indexterm>
-	        <primary>-STABLE</primary>
-		<secondary>downloading with FTP</secondary>
-	      </indexterm>
-	      <listitem>
-		<para>Use <command>ftp</command>.  The source tree for
-		  &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>.
-		  Some of our FTP mirrors may also allow
-		  compressed/tarred grabbing of whole trees.  For example you
-		  see:</para>
-
-		<screen>usr.bin/lex</screen>
-
-		<para>You can do the following to get the whole directory
-		  for you as a tar file:</para>
-
-		<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>
 		<secondary>syncing with CTM</secondary>
--- mirrors/chapter.sgml.orig	Thu Jul 17 10:50:14 2003
+++ mirrors/chapter.sgml	Fri Jul 18 23:02:45 2003
@@ -1563,7 +1563,7 @@
 	  fetch the current <application>CTM</application> sources
 	  directly from:</para>
 	    
-	<para><ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm/"></ulink></para>
+	<para><ulink url="http://www.freebsd.org/cgi/cvsweb.cgi/src/usr.sbin/ctm/"></ulink></para>
 
 	<para>The <quote>deltas</quote> you feed
 	  <application>CTM</application> can be had two ways, FTP or
@@ -2294,8 +2294,8 @@
 
        <para>and so forth for the other languages (you can find the
        full list by browsing the <ulink
-       URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/">FreeBSD
-       FTP server</ulink>).</para>
+       URL="http://www.freebsd.org/cgi/cvsweb.cgi/">FreeBSD
+       CVS repository</ulink>).</para>
 
        <para>With this very useful feature, those users who are on
        slow links or pay by the minute for their Internet connection
--- bibliography/chapter.sgml.orig	Fri Jul 18 20:28:35 2003
+++ bibliography/chapter.sgml	Fri Jul 18 23:06:33 2003
@@ -513,7 +513,7 @@
       
       <listitem>
 	<para><emphasis>The BSD family tree</emphasis>.
-	  <ulink url="ftp://ftp.jp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/misc/bsd-family-tree"></ulink>
+	  <ulink url="http://www.freebsd.org/cgi/cvsweb.cgi/src/share/misc/bsd-family-tree"></ulink>
 	   or <ulink type="html" url="file://localhost/usr/share/misc/bsd-family-tree"><filename>/usr/share/misc/bsd-family-tree</filename></ulink>
 	   on a modern FreeBSD machine.</para>
       </listitem>
>Release-Note:
>Audit-Trail:

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Ken Smith <kensmith@cse.Buffalo.EDU>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/54738: Remove references to branches/ section of FTP site
Date: Tue, 22 Jul 2003 09:40:45 +0200

 On Mon, Jul 21, 2003 at 11:13:28PM -0400, Ken Smith wrote:
 > >Description:
 > 	We want to remove the branches/ section of the FTP site.  This
 > 	patch, removes all references to that from the Handbook that I
 > 	could find.
 
 [...]
 
 You mean ftp://ftp.FreeBSD.org/pub/FreeBSD/branches, or
 ftp://ftp.FreeBSD.org/pub/FreeBSD/{FreeBSD-stable|FreeBSD-current} ?
 
 Marc

From: Ken Smith <kensmith@cse.Buffalo.EDU>
To: Marc Fonvieille <blackend@FreeBSD.org>
Cc: Ken Smith <kensmith@cse.Buffalo.EDU>,
	FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/54738: Remove references to branches/ section of FTP site
Date: Tue, 22 Jul 2003 07:24:27 -0400

 On Tue, Jul 22, 2003 at 09:40:45AM +0200, Marc Fonvieille wrote:
 > On Mon, Jul 21, 2003 at 11:13:28PM -0400, Ken Smith wrote:
 > > >Description:
 > > 	We want to remove the branches/ section of the FTP site.  This
 > > 	patch, removes all references to that from the Handbook that I
 > > 	could find.
 > 
 > [...]
 > 
 > You mean ftp://ftp.FreeBSD.org/pub/FreeBSD/branches, or
 > ftp://ftp.FreeBSD.org/pub/FreeBSD/{FreeBSD-stable|FreeBSD-current} ?
 > 
 
 They're the same thing:
 
 ftp-master 4 % ls -ld FreeBSD-current FreeBSD-stable branches
 lrwxrwxrwx  1 root     wheel     17 Sep  6  2001 FreeBSD-current@ -> branches/-current
 lrwxrwxrwx  1 root     wheel     19 Sep  6  2001 FreeBSD-stable@ -> branches/4.0-stable
 drwxrwxr-x  6 archive  archive  512 Apr 24  2000 branches/
 ftp-master 5 %
 
 If that causes more messes I can help clean them up.  We're hoping to do this
 removal because the support for it among the mirror sites is already flakey.
 Many of the mirror sites don't carry branches/ at all.  One of the machines
 that makes up ftp.freebsd.org only carries a few of the things that are in
 the branches/-current.
 
 -- 
 						Ken Smith
 - From there to here, from here to      |       kensmith@cse.buffalo.edu
   there, funny things are everywhere.   |
                       - Theodore Geisel |

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Ken Smith <kensmith@cse.Buffalo.EDU>
Cc: freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/54738: Remove references to branches/ section of FTP site
Date: Tue, 22 Jul 2003 18:35:53 +0200

 On Tue, Jul 22, 2003 at 04:30:11AM -0700, Ken Smith wrote:
 >  > 
 >  > You mean ftp://ftp.FreeBSD.org/pub/FreeBSD/branches, or
 >  > ftp://ftp.FreeBSD.org/pub/FreeBSD/{FreeBSD-stable|FreeBSD-current} ?
 >  > 
 >  
 >  They're the same thing:
 >  
 >  ftp-master 4 % ls -ld FreeBSD-current FreeBSD-stable branches
 >  lrwxrwxrwx  1 root     wheel     17 Sep  6  2001 FreeBSD-current@ -> branches/-current
 >  lrwxrwxrwx  1 root     wheel     19 Sep  6  2001 FreeBSD-stable@ -> branches/4.0-stable
 >  drwxrwxr-x  6 archive  archive  512 Apr 24  2000 branches/
 >  ftp-master 5 %
 >  
 >  If that causes more messes I can help clean them up.  We're hoping to do this
 >  removal because the support for it among the mirror sites is already flakey.
 >  Many of the mirror sites don't carry branches/ at all.  One of the machines
 >  that makes up ftp.freebsd.org only carries a few of the things that are in
 >  the branches/-current.
 >
 
 But what about ftp://ftp.jp.FreeBSD.org/ ?  They will also stop to
 provide direct access to -CURRENT/-STABLE source via FTP?
 Does it mean that CVSweb will be the only way to get some
 -CURRENT/-STABLE source files?
 
 Marc

From: Ken Smith <kensmith@cse.Buffalo.EDU>
To: Marc Fonvieille <blackend@FreeBSD.org>
Cc: Ken Smith <kensmith@cse.Buffalo.EDU>, freebsd-doc@FreeBSD.org,
	FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/54738: Remove references to branches/ section of FTP site
Date: Tue, 22 Jul 2003 12:45:33 -0400

 On Tue, Jul 22, 2003 at 06:35:53PM +0200, Marc Fonvieille wrote:
 
 > But what about ftp://ftp.jp.FreeBSD.org/ ?  They will also stop to
 > provide direct access to -CURRENT/-STABLE source via FTP?
 
 That was the plan, they get it from ftp-master I believe.
 
 > Does it mean that CVSweb will be the only way to get some
 > -CURRENT/-STABLE source files?
 
 Yes.  We thought that's a better way to get them, it's more functional
 and doesn't load up the mirror system with tons of small files that
 change fairly often.
 
 This is probably still open to discussion if it's a big problem.
 Basically our theory was that the stuff on the FTP site had been
 useful before CVSweb came along but now that it's available the
 load of carrying the branches/ stuff through the mirror system
 isn't worth it.  If the theory is wrong we might be able to come
 up with some sort of alternative.
 
 -- 
 						Ken Smith
 - From there to here, from here to      |       kensmith@cse.buffalo.edu
   there, funny things are everywhere.   |
                       - Theodore Geisel |
State-Changed-From-To: open->closed 
State-Changed-By: kuriyama 
State-Changed-When: Tue Aug 5 18:30:57 PDT 2003 
State-Changed-Why:  
Committed, thanks! 

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