From swear@aa.net  Tue Aug  7 16:30:17 2001
Return-Path: <swear@aa.net>
Received: from localhost.localdomain (host68.207.55.120.aadsl.com [207.55.120.68])
	by hub.freebsd.org (Postfix) with ESMTP id 9110637B40C
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  7 Aug 2001 16:30:17 -0700 (PDT)
	(envelope-from swear@aa.net)
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.3/8.11.3) id f77NWSb50108;
	Tue, 7 Aug 2001 16:32:28 -0700 (PDT)
	(envelope-from swear@aa.net)
Message-Id: <0fk80fv438.80f@localhost.localdomain>
Date: 07 Aug 2001 16:32:27 -0700
From: swear@aa.net (Gary W. Swearingen)
Sender: jojo@localhost.localdomain
Reply-To: swear@aa.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: Handbook: A few changes related to cvsup collections.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         29522
>Category:       docs
>Synopsis:       Handbook: A few changes related to cvsup collections.
>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:   Tue Aug 07 16:40:01 PDT 2001
>Closed-Date:    Sun Sep 2 05:16:07 PDT 2001
>Last-Modified:  Sun Sep 02 05:16:34 PDT 2001
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.3-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

In the "mirrors" chapter:

1) "described here", where "here" is a link, doesn't translate well to
ASCII.

2) The description of the "doc-all" collection doesn't warn people that
it doesn't include the FreeBSD.org web site.  Those who read that the
site's files are part of the Documentation Project might not read far to
the end of the list to read that "doc-all" doesn't mean all of the FDP's
docs.

3) Mention of the "www" collection as "WWW data" is rather nebulous.
================
>How-To-Repeat:
n/a
================
>Fix:

patch -d /*/doc/en_US.ISO8859-1/books/handbook/mirrors < this-PR

*** /tmp/chapter.sgml	Tue Aug  7 14:56:34 2001
--- chapter.sgml	Tue Aug  7 15:45:15 2001
***************
*** 1845,1852 ****
  	  <para>The files available via <application>CVSup</application>
  	    are organized into named groups called
  	    <quote>collections</quote>.  The collections that are
! 	    available are described <link
! 	      linkend="cvsup-collec">here</link>.  In this example, we
  	    wish to receive the entire main source tree for the FreeBSD
  	    system.  There is a single large collection
  	    <literal>src-all</literal> which will give us all of that.
--- 1845,1853 ----
  	  <para>The files available via <application>CVSup</application>
  	    are organized into named groups called
  	    <quote>collections</quote>.  The collections that are
! 	    available are described in a <link
! 	      linkend="cvsup-collec">following section</link>.  In this
!             example, we
  	    wish to receive the entire main source tree for the FreeBSD
  	    system.  There is a single large collection
  	    <literal>src-all</literal> which will give us all of that.
***************
*** 2408,2415 ****
  		<term><literal>doc-all release=cvs</literal></term>
  
  		<listitem>
! 		  <para>Sources for the FreeBSD handbook and other
! 		    documentation.</para>
  		</listitem>
  	      </varlistentry>
  
--- 2409,2417 ----
  		<term><literal>doc-all release=cvs</literal></term>
  
  		<listitem>
! 		  <para>Sources for the FreeBSD handbook and some other
! 		    documentation.  It does not include files for the
!                     FreeBSD WWW site.</para>
  		</listitem>
  	      </varlistentry>
  
***************
*** 3082,3088 ****
  		<term><literal>www release=cvs</literal></term>
  		
  		<listitem>
! 		  <para>The sources for the World Wide Web data.</para>
  		</listitem>
  	      </varlistentry>
  	    </variablelist>
--- 3084,3090 ----
  		<term><literal>www release=cvs</literal></term>
  		
  		<listitem>
! 		  <para>The sources for the FreeBSD WWW site.</para>
  		</listitem>
  	      </varlistentry>
  	    </variablelist>
***************
*** 3119,3126 ****
  	  <term><literal>www release=current</literal></term>
  
  	  <listitem>
! 	    <para>The installed World Wide Web data.  Used by WWW mirror
! 	      sites.</para>
  	  </listitem>
  	</varlistentry>
        </variablelist>
--- 3121,3128 ----
  	  <term><literal>www release=current</literal></term>
  
  	  <listitem>
! 	    <para>The pre-processed FreeBSD WWW site files (not the
!               source files).  Used by WWW mirror sites.</para>
  	  </listitem>
  	</varlistentry>
        </variablelist>
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Sun Sep 2 05:16:07 PDT 2001 
State-Changed-Why:  
Your changes have been added, thanks! 


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