Date: 07 Aug 2001 16:32:27 -0700 From: swear@aa.net (Gary W. Swearingen) To: FreeBSD-gnats-submit@freebsd.org Subject: docs/29522: Handbook: A few changes related to cvsup collections. Message-ID: <0fk80fv438.80f@localhost.localdomain>
next in thread | raw e-mail | index | archive | help
>Number: 29522
>Category: docs
>Synopsis: Handbook: A few changes related to cvsup collections.
>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: Tue Aug 07 16:40:01 PDT 2001
>Closed-Date:
>Last-Modified:
>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:
>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?0fk80fv438.80f>