Author: Andres Miller <a1kmm@mware.virtualave.net>
[ircu2.10.12-pk.git] / doc / readme.cvs
1
2 Notes on checking out from the Undernet CVS archive and maintenance.
3
4 General Strategy:
5 The main trunk of the tree will be used for ongoing development only
6 (alpha) this code is not intended to be used on the production network.
7 When development has reached a point of relative stability a tag will be
8 applied to the development branch and a beta tag will be applied to that
9 branch. For beta test servers only the tagged branches will be used.
10 When a tag is applied we will also produce a snapshot tarball of the
11 tag. Once a beta tagged release has been proven stable any fixes will be
12 merged into the main tagged version and the code will be voted on for
13 release. Fixes after release will be tagged with a patchlevel tag.
14
15 You check out a tagged release by specifying the -r tag option to cvs.
16 This is the command to check out the most recent tagged version of
17 ircu2.10.07:
18 cvs -d :pserver:anoncvs@coder-com.undernet.org:/home/coder-com/cvs co -r u2_10_07_pl6 -P ircu2.10
19
20 Developers doing maintenance and bug fixes should only check out the
21 current tagged patchlevel for the affected version. Once the fix has
22 proven stable, it will be merged into the tree the fix is relative to.
23
24 We will not merge the changes that have been made to ircu2.10.07 since
25 it's release into the development branch, the 2.10.07 branch is a
26 maintenance only branch.
27
28 If you have any questions on how to check out tagged versions check out
29 the coder-com web page http://coder-com.undernet.org/cvs.html or the cvs
30 manual page. If you're really stumped feel free to ask on coder-com.
31
32 We will put out new tarballs for every tagged release which will be
33 available on the coder-com web page.
34
35 Naming Conventions:
36
37 Tag Names:
38 Major release - u2_10_10
39 Beta release  - u2_10_10_beta01
40 Production patch - u2_10_07_pl9
41
42 The tree currently looks like this:
43
44 Trunk: development only
45 ------------------------------------------------
46   \                       \
47    \----- u2_10_07         \---- u2_10_10 --- release ---------
48        \                      \                        \
49         \--- u2_10_07_pl9      \--- u2_10_10_beta06     \ u2_10_10_pl01
50
51 Patches will be rolled into the tagged branch and eventually rolled into
52 the development branch. All new development should be relative to the
53 trunk, only bugfixes and maintenance coding should be applied to any
54 tagged version. Developers doing maintenance should only check out the
55 latest pl or beta tag and apply the changes relative to that tag. These
56 changes will be committed to the tag they were checked out from and once
57 proven stable they will be merged into the main tagged trunk by the
58 maintainer.
59
60 Where to get CVS:
61 http://www.loria.fr/~molli/cvs-index.html
62
63 Checking out:
64 First you need to login to cvs: 
65 cvs -d :pserver:anoncvs@coder-com.undernet.org:/home/coder-com/cvs login
66
67 It will prompt you for a password. The password is "anoncvs". 
68
69 To check out the recommended patchlevel for ircu2.10.07 use: 
70 cvs -d :pserver:anoncvs@coder-com.undernet.org:/home/coder-com/cvs co -r u2_10_07_pl6 -P ircu2.10
71
72 For the ircu2.10.10 beta archive use: 
73 cvs -d :pserver:anoncvs@coder-com.undernet.org:/home/coder-com/cvs co -r u2_10_10_beta06 -P ircu2.10
74
75 To check out the current development archive use: 
76 cvs -d :pserver:anoncvs@coder-com.undernet.org:/home/coder-com/cvs co -P ircu2.10
77
78 For the ircu3 pipedream archive use: 
79 cvs -d :pserver:anoncvs@coder-com.undernet.org:/home/coder-com/cvs co -P ircu3
80
81 When you want to update your source tree later to the latest version, use 
82 cvs update -P
83
84 inside  ircu2.10/,  the directory ircu2.10 was checked out to. 
85
86 How to find the most current available release:
87 We will announce the most current release tag when we make it available, in general
88 you will check out the main branch of any given tree, if you want the current production
89 release use the "u2_10_07" tag, for patched versions use a patchlevel tag "u2_10_07_pl6".
90 You can always find the most recent tag for any version by looking at the Undernet
91 Coder Com CVS archive: http://coder-com.undernet.org/cgi-bin/cvsweb.cgi
92
93