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