Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 18 Jan 2002 10:27:01 -0500 (EST)
From:      Tom Rhodes <darklogik@pittgoth.com>
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/34037: [PATCH] Updating handbook-mirrors chapter
Message-ID:  <200201181527.g0IFR1n67190@pittgoth.com>

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

>Number:         34037
>Category:       docs
>Synopsis:       [PATCH] Updating handbook-mirrors chapter
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jan 18 07:30:00 PST 2002
>Closed-Date:
>Last-Modified:
>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:
>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?200201181527.g0IFR1n67190>