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"> <sect1 id="cvs-tags">
<title>CVS Tags</title> <title>CVS Tags</title>
<para>When obtaining or updating sources from <para>When obtaining or updating sources using
<application>cvs</application> and <application>cvs</application> or
<application>CVSup</application> a revision tag (reference to a <application>CVSup</application>, a revision tag must be specified.
date in time) must be specified.</para> A revision tag refers to either a particular line of &os
<para>A revision tag refers to either a particular line of FreeBSD
development, or a specific point in time. The first type are called development, or a specific point in time. The first type are called
<quote>branch tags</quote>, the second type are called <quote>release <quote>branch tags</quote>, and the second type are called
tags</quote>.</para> <quote>release tags</quote>.</para>
<sect2> <sect2>
<title>Branch Tags</title> <title>Branch Tags</title>
@ -2379,10 +2377,20 @@ doc/zh_*</screen>
<sect2> <sect2>
<title>Release Tags</title> <title>Release Tags</title>
<para>These tags correspond to the FreeBSD <filename>src/</filename> <para>These tags refer to a specific point in time when a particular
tree (and <filename>ports/</filename>, <filename>doc/</filename>, and version of &os; was released. The release engineering process is
<filename>www/</filename> trees) at a specific point in time, when a documented in more detail by the
particular version of FreeBSD was released.</para> <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> <variablelist>
<varlistentry> <varlistentry>