Improve the description of CVS tags and branches. Point the reader to

the RE documentation and summarize the current tag naming scheme.

PR:		docs/66610
Submitted by:	Chuck Swiger <chuck@pkix.net>
This commit is contained in:
Giorgos Keramidas 2004-07-07 22:09:57 +00:00
parent 0ac125b745
commit b840205d80
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=21390

View file

@ -2208,15 +2208,13 @@ doc/zh_*</screen>
<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.</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>
<sect2>
<title>Branch Tags</title>
@ -2379,10 +2377,20 @@ doc/zh_*</screen>
<sect2>
<title>Release Tags</title>
<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 by the
<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> documents.
The <filename role="directory">src</filename> tree uses tag names that
start with <literal>RELENG_</literal> tags.
The <filename role="directory">ports</filename> and
<filename role="directory">docs</filename> trees use tags whose names
begin with <literal>RELEASE</literal> tags.
Finally, the <filename role="directory">www/</filename> tree is not
tagged with any special name for releases.</para>
<variablelist>
<varlistentry>