From darklogik@pittgoth.com  Fri Jan 18 07:25:55 2002
Return-Path: <darklogik@pittgoth.com>
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by hub.freebsd.org (Postfix) with ESMTP id 2DF2B37B41A
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 18 Jan 2002 07:25:53 -0800 (PST)
Received: (from darklogik@localhost)
	by pittgoth.com (8.11.6/8.11.6) id g0IFR1n67190;
	Fri, 18 Jan 2002 10:27:01 -0500 (EST)
	(envelope-from darklogik)
Message-Id: <200201181527.g0IFR1n67190@pittgoth.com>
Date: Fri, 18 Jan 2002 10:27:01 -0500 (EST)
From: Tom Rhodes <darklogik@pittgoth.com>
Reply-To: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Updating handbook-mirrors chapter
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         34037
>Category:       docs
>Synopsis:       [PATCH] Updating handbook-mirrors chapter
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jan 18 07:30:00 PST 2002
>Closed-Date:    Wed Jan 30 19:04:30 PST 2002
>Last-Modified:  Wed Jan 30 19:06:33 PST 2002
>Originator:     
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD localhost 5.0-CURRENT

>Description:
The cvsup section of the handbook, I feel, lacks some important information.  Other than that, it did
need a bit of a touch up, this diff will add a link to the staples website as they carry boxed FreeBSD sets, more
information about the refuse and sup files, slight grammer correction :)
>How-To-Repeat:
Read the chapter, use cvsup on a slow connection, and presto, instant "Why wasn't this explained?"
>Fix:
Apply this patch



*** chapter.sgml.old	Fri Jan 18 10:26:05 2002
--- chapter.sgml	Fri Jan 18 01:04:49 2002
***************
*** 25,30 ****
--- 25,37 ----
  	  </address>
  	</listitem>
  
+         <listitem>
+ 	  <address>
+ 	    <otheraddr>Staples</otheraddr>
+ 	    WWW: <otheraddr><ulink url="http://www.staples.com/">http://www.staples.com</ulink></otheraddr>
+ 	  </address>
+ 	</listitem>
+ 
  	<listitem>
  	  <address>
  	    <otheraddr>Frys Electronics</otheraddr>
***************
*** 1631,1637 ****
  	may see references to <application>sup</application>.
  	<application>Sup</application> was the predecessor of
  	<application>CVSup</application>, and it served a similar
! 	purpose.<application>CVSup</application> is in used in much the
  	same way as sup and, in fact, uses configuration files which are
  	backward-compatible with <command>sup</command>'s.
  	<application>Sup</application> is no longer used in the FreeBSD
--- 1638,1644 ----
  	may see references to <application>sup</application>.
  	<application>Sup</application> was the predecessor of
  	<application>CVSup</application>, and it served a similar
! 	purpose.<application>CVSup</application> is used much in the
  	same way as sup and, in fact, uses configuration files which are
  	backward-compatible with <command>sup</command>'s.
  	<application>Sup</application> is no longer used in the FreeBSD
***************
*** 1769,1775 ****
--- 1776,1797 ----
  
  	  <programlisting>src-all</programlisting>
  	</listitem>
+       </itemizedlist>
  
+ 	  <note>
+ 	    <para>You can specify a list of collections just by adding them
+ 	      downward, for instance:
+ 	      <programlisting>src-all</programlisting>
+ 	      <programlisting>doc-all</programlisting>
+ 	      <programlisting>ports-audio</programlisting>
+ 	      will obtain the src-all collection, the doc-all
+ 	      collection, and the ports-audio collection, but
+ 	      this is only recommended if you have a fast internet
+ 	      connection.</para>
+ 	    </note>
+ 
+ 
+       <itemizedlist>
  	<listitem>
  	  <para><anchor id="cvsup-config-vers">Which version(s) of them
  	    do you want?</para>
***************
*** 2020,2032 ****
         of the repository is the first <quote>directory</quote> in the
         <emphasis>refuse file</emphasis>.</para>
  
!        <para>With this very useful feature, those users who are on
!        slow links or pay by the minute for their Internet connection
!        will be able to save valuable time as they will no longer need
!        to download files that they will never use. For more
!        information on <emphasis>refuse files</emphasis> and other neat
!        features of <application>CVSup</application>, please view its
!        manual page.</para> 
        </sect3>
      </sect2>
      
--- 2042,2082 ----
         of the repository is the first <quote>directory</quote> in the
         <emphasis>refuse file</emphasis>.</para>
  
!        <para>A typical refuse file may have the following list:</para>
! 
!        <screen>ports/chinese
! ports/french
! ports/german
! ports/hebrew
! ports/japanese
! ports/korean
! ports/russian
! ports/ukrainian
! ports/vietnamese
! doc/de_DE.ISO8859-1
! doc/es_ES.ISO8859-1
! doc/fr_FR.ISO8859-1
! doc/it_IT.ISO8859-15
! doc/ja_JP.eucJP
! doc/nl_NL.ISO8859-1
! doc/ru_RU.KOI8-R
! doc/sr_YU.ISO8859-2
! doc/zh_TW.Big5</screen>
! 
!         <para>As of this writing, that is a current and complete
! 	  list of all the different language document files and
! 	  ports, please feel free to use the list, it will save
! 	  time when downloading, because you will not need to
! 	  download everything, and then modify your refuse file
! 	  to your own preferences</para>
! 
!       <para>With this very useful feature, those users who are on
!         slow links or pay by the minute for their Internet connection
!         will be able to save valuable time as they will no longer need
!         to download files that they will never use. For more
!         information on <emphasis>refuse files</emphasis> and other neat
!         features of <application>CVSup</application>, please view its
!         manual page.</para>
        </sect3>
      </sect2>
      
***************
*** 2044,2050 ****
  	will display a GUI window with some buttons to do the usual
  	things.  Press the <quote>go</quote> button, and watch it
  	run.</para>
!       
        <para>Since you are updating your actual
  	<filename>/usr/src</filename> tree in this example, you will
  	need to run the program as <username>root</username> so that
--- 2094,2106 ----
  	will display a GUI window with some buttons to do the usual
  	things.  Press the <quote>go</quote> button, and watch it
  	run.</para>
! 
! 	<note>
! 	  <para>In some cases, you will need to specify the directory
! 	    that contains <application>CVSup</application> which is
! 	    typically <filename>/usr/local/bin/cvsup</filename></para>
! 	</note>
! 
        <para>Since you are updating your actual
  	<filename>/usr/src</filename> tree in this example, you will
  	need to run the program as <username>root</username> so that
***************
*** 2088,2094 ****
  	details of all the file updates it is doing.  There are three
  	levels of verbosity, from <option>-L 0</option> to
  	<option>-L 2</option>.  The default is 0, which means total
! 	silence except for error messages.</para>
        
        <para>There are plenty of other options available.  For a brief
  	list of them, type <command>cvsup -H</command>.  For more
--- 2144,2151 ----
  	details of all the file updates it is doing.  There are three
  	levels of verbosity, from <option>-L 0</option> to
  	<option>-L 2</option>.  The default is 0, which means total
! 	silence except for error messages, 1 adds a little bit more
! 	information, and 2 will give you a good bit of information.</para>
        
        <para>There are plenty of other options available.  For a brief
  	list of them, type <command>cvsup -H</command>.  For more
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Wed Jan 23 00:26:27 PST 2002 
Responsible-Changed-Why:  
I've partially committed the changes from this. 
Working with Tom on the rest. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34037 

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/34037 [PATCH]
Date: Wed, 30 Jan 2002 17:12:38 -0500 (EST)

 Apply this patch, it will add another FreeBSD Vender to your list, along with
 adding some more information for a users refuse file.  I feel this information
 is important for new users to know and understand as slower connections
 will take longer to download, it may also subtract some server load on
 everyone if hundreds of users know about what ports/docs they do not really
 need to download...  Thanks alot
 
 --Tom (Darklogik) Rhodes
 
 
 
 *** chapter.sgml.old	Tue Jan 29 22:02:18 2002
 --- chapter.sgml	Wed Jan 30 16:26:02 2002
 ***************
 *** 1,7 ****
   <!--
        The FreeBSD Documentation Project
   
 !      $FreeBSD: doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml,v 1.188 2002/01/25 05:17:00 murray Exp $
   -->
   
   <appendix id="mirrors">
 --- 1,7 ----
   <!--
        The FreeBSD Documentation Project
   
 !      $FreeBSD: doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml,v 1.189 2002/01/30 15:50:16 kuriyama Exp $
   -->
   
   <appendix id="mirrors">
 ***************
 *** 38,43 ****
 --- 38,50 ----
   	    WWW: <otheraddr><ulink url="http://www.microcenter.com/">http://www.microcenter.com/</ulink></otheraddr>
   	  </address>
   	</listitem>
 + 
 +         <listitem>
 +           <address>
 +             <otheraddr>Staples</otheraddr>
 +             WWW: <otheraddr><ulink url="http://www.staples.com/">http://www.staples.com/</ulink></otheraddr>
 +           </address>
 +         </listitem>
         </itemizedlist>
       </sect2>
   
 ***************
 *** 2008,2020 ****
          <emphasis>refuse file</emphasis>:</para>
   
          <screen>ports/chinese
   ports/german
   ports/japanese
   ports/korean
   ports/russian
   ports/vietnamese
   doc/es_ES.ISO8859-1
 ! doc/ja_JP.eucJP</screen>
   
          <para>and so forth for the other languages. Note that the name
          of the repository is the first <quote>directory</quote> in the
 --- 2021,2044 ----
          <emphasis>refuse file</emphasis>:</para>
   
          <screen>ports/chinese
 + ports/french
   ports/german
 + ports/hebrew
   ports/japanese
   ports/korean
   ports/russian
 + ports/ukrainian
   ports/vietnamese
 + doc/de_DE.ISO8859-1
   doc/es_ES.ISO8859-1
 ! doc/fr_FR.ISO8859-1
 ! doc/it_IT.ISO8859-15
 ! doc/ja_JP.eucJP
 ! doc/nl_NL.ISO8859-1
 ! doc/pt_BR.ISO8859-1
 ! doc/ru_RU.KOI8-R
 ! doc/sr_YU.ISO8859-2
 ! doc/zh_TW.Big5</screen>
   
          <para>and so forth for the other languages. Note that the name
          of the repository is the first <quote>directory</quote> in the
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Jan 30 19:04:30 PST 2002 
State-Changed-Why:  
Committed in two parts.  First Staples was added, then the refuse file 
updated in revisions 1.190 and 1.191 of handbook/mirrors/chapter.sgml 
Thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34037 
>Unformatted:
