ircu2.10.12 pk910 fork
[ircu2.10.12-pk.git] / doc / readme.cvs
1 Notes on checking out from the Undernet CVS archive.
2
3 The main trunk of the tree (HEAD) will be used for development only.
4 When the maintainers believe the code is stable enough to prepare for
5 a release, they will make a branch for that release series.
6
7 Each branch will have a base name, which is the name of the release
8 series where dots are replaced with underscores.  The branch name will
9 be the base name with the suffix "_branch".  Once an official release
10 is made, each release branch will have one or more fixed tags and one
11 moving tag.  The fixed tags will indicate specific patchlevels, and
12 have the base name with a suffix giving the zero-based patchlevel.
13 The moving tag's name will be the base name, and will always point to
14 the same state as some fixed tag on the branch.
15
16 This allows developers to easily track the most recent version of any
17 branch (by checking out using the branch's name), and allows server
18 admins to easily track the most recent release on the branch (by
19 checking out using the branch's base name).
20
21 For example, for the ircu2.10.12 release series, the branch's base
22 name is u2_10_12.  The branch's name is u2_10_12_branch.  The first
23 release (ircu2.10.12) would be permanently tagged as u2_10_12_0, and
24 until an update is released, it would also have the tag u2_10_12.
25 When the first update is released, it would be permanently tagged as
26 u2_10_12_01, and the tag u2_10_12 would be changed to point to it.
27
28 If the current stable series is 2.10.12, server admins should check
29 out the code using the command:
30   cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu co -r u2_10_12 -P ircu2.10
31 Admins may only run unreleased code on Undernet with coder-com
32 approval.  The command above will retrieve the most recent release.
33
34 Developers should check out the release branch using the command:
35   cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu co -r u2_10_12_branch -P ircu2.10
36
37 http://sourceforge.net/cvs/?group_id=63470 gives more information on
38 using CVS to access the ircu code; http://www.nongnu.org/cvs/ gives
39 more information on using CVS in general.
40
41 NOTE: Release before ircu2.10.12 used a different branching scheme.
42 Older revisions of this readme.cvs explain that system.