docs/66610: Update handbook re: CVSup tags

[Chuck Swiger]

>Number:         66610
>Category:       docs
>Synopsis:       Update handbook re: CVSup tags
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu May 13 07:20:21 PDT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Chuck Swiger
>Release:        FreeBSD 4.10-PRERELEASE i386
>Organization:
PKIx
>Environment:
System: FreeBSD sec.pkix.net 4.10-PRERELEASE FreeBSD 4.10-PRERELEASE #4: Sat May 8 21:51:36 EDT 2004 root at sec.pkix.net:/usr/obj/usr/src/sys/NORMAL i386

>Description:

Doc change request in Message-id: <20040512224755.GB34090 at xor.obsecurity.org>

>How-To-Repeat:

N/A.

>Fix:

--- /usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml	Sat Apr 24 13:41:22 2004
+++ /tmp/chapter.sgml	Thu May 13 10:00:37 2004
@@ -2207,11 +2207,9 @@
 
-    <para>When obtaining or updating sources from
-      <application>cvs</application> and
-      <application>CVSup</application> a revision tag (reference to a
-      date in time) must be specified.</para>
-
-    <para>A revision tag refers to either a particular line of FreeBSD
+    <para>When obtaining or updating sources using
+      <application>cvs</application> or
+      <application>CVSup</application>, a revision tag must be specified.
+      A revision tag refers to either a particular line of &os
       development, or a specific point in time.  The first type are called
-      <quote>branch tags</quote>, the second type are called <quote>release
-	tags</quote>.</para>
+      <quote>branch tags</quote>, and the second type are called
+      <quote>release tags</quote>.</para>
 
@@ -2378,6 +2376,13 @@
 
-      <para>These tags correspond to the FreeBSD <filename>src/</filename>
-	tree (and <filename>ports/</filename>, <filename>doc/</filename>, and
-	<filename>www/</filename> trees) at a specific point in time, when a
-	particular version of FreeBSD was released.</para>
+      <para>These tags refer to a specific point in time when a particular
+	version	of &os was released.  The release engineering process is
+	documented in more detail at <ulink
+	url="http://www.freebsd.org/releng/"Release Engineering Information
+	</ulink> and <ulink
+	url="http://www.freebsd.org/doc/en_US.ISO8859-1/articles/releng/release-proc.html"
+	Release Process</ulink>.  The <filename>src/</filename> tree uses
+	RELENG_* tags; the <filename>ports/</filename> and
+	<filename>docs/<filename> trees use RELEASE_* tags; and the
+	<filename>www/</filename> tree is not specially tagged for releases.
+	</para>
 

>Release-Note:
>Audit-Trail:
>Unformatted: