From b6cb62b8b1865e91c52de8c0d5dd6cca500e00df Mon Sep 17 00:00:00 2001
From: John Polstra <jdp@FreeBSD.org>
Date: Tue, 22 Jul 1997 03:21:57 +0000
Subject: [PATCH] Add warnings emphasizing that tags such as RELENG_2_2 must
not be used for the ports-* collections.
---
handbook/cvsup.sgml | 30 ++++++++++++++++++++++++------
1 file changed, 24 insertions(+), 6 deletions(-)
diff --git a/handbook/cvsup.sgml b/handbook/cvsup.sgml
index 92dd82569f..a7d715a656 100644
--- a/handbook/cvsup.sgml
+++ b/handbook/cvsup.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: cvsup.sgml,v 1.22 1997-07-16 19:17:28 jdp Exp $ -->
+<!-- $Id: cvsup.sgml,v 1.23 1997-07-22 03:21:57 jdp Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect1><heading>CVSup<label id="cvsup"></heading>
@@ -189,6 +189,13 @@ directly from the CVS repository, which contains all of the versions.
You specify which one of them you want using the "tag=" and "date="
value fields.
+<p><bf>WARNING:</bf> Be very careful to specify any "tag=" fields
+correctly. Some tags are valid only for certain collections of
+files. If you specify an incorrect or misspelled tag, CVSup will
+delete files which you probably do not want deleted.
+In particular, use <em>only </em>"<tt>tag=.</tt>" for the "ports-*"
+collections.
+
<p>The "tag=" field names a symbolic tag in the repository. There are
two kinds of tags, revision tags and branch tags. A revision tag
refers to a specific revision. Its meaning stays the same from day to
@@ -203,11 +210,14 @@ different tomorrow than it means today.
<tag/tag=./
The main line of development, also known as FreeBSD-current.
Note: the "." is not punctuation; it is the name of the tag.
+ Valid for all collections.
<tag/tag=RELENG_2_2/
The line of development for FreeBSD-2.2.x.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_1_0/
The line of development for FreeBSD-2.1.x, also known as
FreeBSD-stable.
+ Not valid for the ports-* collections.
</descrip>
<p>Here are the revision tags that users might be interested in:
@@ -215,27 +225,35 @@ different tomorrow than it means today.
<descrip>
<tag/tag=RELENG_2_2_2_RELEASE/
FreeBSD-2.2.2.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_2_1_RELEASE/
FreeBSD-2.2.1.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_2_0_RELEASE/
FreeBSD-2.2.0.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_1_7_RELEASE/
FreeBSD-2.1.7.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_1_6_1_RELEASE/
FreeBSD-2.1.6.1.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_1_6_RELEASE/
FreeBSD-2.1.6.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_1_5_RELEASE/
FreeBSD-2.1.5.
+ Not valid for the ports-* collections.
<tag/tag=RELENG_2_1_0_RELEASE/
FreeBSD-2.1.0.
+ Not valid for the ports-* collections.
</descrip>
-<p>Be very careful to type the tag name exactly as shown. CVSup cannot
-distinguish between valid and invalid tags. If you misspell the tag,
-CVSup will behave as though you had specified a valid tag which happens
-to refer to no files at all. It will delete your existing sources in
-that case.
+<p><bf>WARNING:</bf> Be very careful to type the tag name exactly as
+shown. CVSup cannot distinguish between valid and invalid tags.
+If you misspell the tag, CVSup will behave as though you had
+specified a valid tag which happens to refer to no files at all.
+It will delete your existing sources in that case.
<p>When you specify a branch tag, you normally receive the latest versions
of the files on that line of development. If you wish to receive some