Complete list of CVS tags are mentioned twice: in anoncvs and cvsup.

* Make a new appendix section containing these tags
 * Adjust anoncvs/cvsup verbage to point to new section
This commit is contained in:
Chern Lee 2001-10-09 23:53:00 +00:00
parent 694c04e2e9
commit e685e7b58e
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=10905

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml,v 1.160 2001/09/24 02:12:15 murray Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml,v 1.161 2001/09/26 16:42:02 jdp Exp $
-->
<appendix id="mirrors">
@ -1106,226 +1106,12 @@
specific revision, it may mean something different tomorrow than
it means today.</para>
<para>Here are the branch tags that users might be interested
in (keep in mind that the only tags valid for the <link
linkend="ports">ports collection</link> is
<literal>HEAD</literal>).</para>
<variablelist>
<varlistentry>
<term>HEAD</term>
<listitem>
<para>Symbolic name for the main line, or FreeBSD-CURRENT.
Also the default when no revision is specified.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4</term>
<listitem>
<para>The line of development for FreeBSD-4.X, also known
as FreeBSD-STABLE.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_4</term>
<listitem>
<para>The release branch for FreeBSD-4.4, used only
for security advisories and other seriously critical fixes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_3</term>
<listitem>
<para>The release branch for FreeBSD-4.3, used only
for security advisories and other seriously critical fixes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3</term>
<listitem>
<para>The line of development for FreeBSD-3.X, also known
as 3.X-STABLE.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2</term>
<listitem>
<para>The line of development for FreeBSD-2.2.X, also known
as 2.2-STABLE. This branch is mostly obsolete.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Here are the revision tags that users might be interested
<para><xref linkend="cvs-tags"> contains revision tags that users
might be interested
in. Again, none of these are valid for the ports collection
since the ports collection does not have multiple
revisions.</para>
<variablelist>
<varlistentry>
<term>RELENG_4_4_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.4.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_3_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.3.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_2_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_1_1_RELEASE</term>
<listitem>
<para>FreeBSD 4.1.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_1_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_0_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_5_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.5.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_4_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.4.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_3_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.3.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_2_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_1_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_0_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_8_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.8.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_7_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.7.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_6_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.6.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_5_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.5.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_2_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_1_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_0_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.0.</para>
</listitem>
</varlistentry>
</variablelist>
<para>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 past version, you can do so by
@ -1987,230 +1773,14 @@
mean something different tomorrow than it means
today.</para>
<para>Here are the branch tags that users might be interested
in. Keep in mind that only the <literal>tag=.</literal> is
<para><xref linkend="cvs-tags"> contains branch tags that
users might be interested in. When specifying a tag in
<application>CVSup</application>'s configuration file, it
must be prececeded with <literal>tag=</literal>
(<literal>RELENG_4</literal> will become
<literal>tag=RELENG_4</literal>).
Keep in mind that only the <literal>tag=.</literal> is
relevant for the ports collection.</para>
<variablelist>
<varlistentry>
<term>tag=.</term>
<listitem>
<para>The main line of development, also known as
FreeBSD-CURRENT.</para>
<note>
<para>The <literal>.</literal> is not punctuation; it
is the name of the tag. Valid for all
collections.</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4</term>
<listitem>
<para>The line of development for FreeBSD-4.X, also known as
FreeBSD-STABLE.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4_4</term>
<listitem>
<para>The release branch for FreeBSD-4.4, used only
for security advisories and other seriously critical
fixes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4_3</term>
<listitem>
<para>The release branch for FreeBSD-4.3, used only
for security advisories and other seriously critical
fixes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_3</term>
<listitem>
<para>The line of development for FreeBSD-3.X</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2</term>
<listitem>
<para>The line of development for FreeBSD-2.2.X, also
known as 2.2-STABLE.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Here are the revision tags that users might be interested
in. Again, these are not valid for the ports
collection.</para>
<variablelist>
<varlistentry>
<term>tag=RELENG_4_4_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.4.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4_3_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.3.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4_2_0_RELEASE</term>
<listitem>
<para>FreeBSD-4.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4_1_1_RELEASE</term>
<listitem>
<para>FreeBSD-4.1.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4_1_0_RELEASE</term>
<listitem>
<para>FreeBSD-4.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_4_0_0_RELEASE</term>
<listitem>
<para>FreeBSD-4.0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_3_5_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.5.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_3_4_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.4.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_3_3_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.3.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_3_2_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_3_1_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_3_0_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2_8_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.8.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2_7_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.7.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2_6_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.6.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2_5_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.5.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2_2_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2_1_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>tag=RELENG_2_2_0_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.0.</para>
</listitem>
</varlistentry>
</variablelist>
<warning>
<para>Be very careful to type the tag name exactly as shown.
@ -3975,7 +3545,247 @@ doc/ja_JP.eucJP</screen>
</variablelist>
</sect2>
</sect1>
<sect1 id="cvs-tags">
<title>CVS Tags</title>
<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. The following tags are
available, each specifying different branches of FreeBSD at
different points of time:</para>
<note>
<para>The ports tree does not have any tag associated with it,
it is always CURRENT.</para>
</note>
<para>The most common tags are:</para>
<variablelist>
<varlistentry>
<term>HEAD</term>
<listitem>
<para>Symbolic name for the main line, or FreeBSD-CURRENT.
Also the default when no revision is specified.</para>
<para>In <application>CVSup</application>, this tag is represented
by a <literal>.</literal> (not punctuation, but a literal
<literal>.</literal> character).</para>
<note>
<para>In CVS, this is the default when no revision tag is
specified. It is usually <emphasis>not</emphasis>
a good idea to checkout or update to CURRENT sources
on a STABLE machine, unless that is your intent.</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4</term>
<listitem>
<para>The line of development for FreeBSD-4.X, also known
as FreeBSD-STABLE.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_4</term>
<listitem>
<para>The release branch for FreeBSD-4.4, used only
for security advisories and other seriously critical fixes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_3</term>
<listitem>
<para>The release branch for FreeBSD-4.3, used only
for security advisories and other seriously critical fixes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3</term>
<listitem>
<para>The line of development for FreeBSD-3.X, also known
as 3.X-STABLE.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2</term>
<listitem>
<para>The line of development for FreeBSD-2.2.X, also known
as 2.2-STABLE. This branch is mostly obsolete.</para>
</listitem>
</variablelist>
<para>Other revision tags that are available include:</para>
<variablelist>
<varlistentry>
<term>RELENG_4_4_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.4.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_3_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.3.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_2_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_1_1_RELEASE</term>
<listitem>
<para>FreeBSD 4.1.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_1_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_4_0_0_RELEASE</term>
<listitem>
<para>FreeBSD 4.0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_5_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.5.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_4_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.4.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_3_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.3.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_2_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_1_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_3_0_0_RELEASE</term>
<listitem>
<para>FreeBSD-3.0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_8_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.8.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_7_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.7.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_6_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.6.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_5_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.5.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_2_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.2.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_1_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.1.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RELENG_2_2_0_RELEASE</term>
<listitem>
<para>FreeBSD-2.2.0.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="mirrors-afs">
<title>AFS Sites</title>