Whamcloud - gitweb
- many small makefile changes to build package conveniently.
[fs/lustre-release.git] / lustre / doc / VERSIONING
1 Lustre versioning
2 =================
3
4 0.0.1  2/19/2002 <braam@clusterfs.com>
5 0.0.2  3/14/2002 <braam@clusterfs.com> describe branches / stable tag
6
7 This document describes versioning of source and binaries for Lustre.
8
9 CVS
10 ===
11
12 Versions will have 4 digits:
13                      major.minor.patch.test
14
15 Such versions will be tagged in CVS as:  
16                      v1_2_11_7
17 and referred to as:
18                      1.2.11.7
19 encoded as:
20                      0x01021107
21
22 Usage: 
23 ------
24
25 New numbers are used as follows: 
26
27 1. major: 
28  - increased when major new functionality becomes available
29 2. minor: 
30  - even: for each new release with new functionality
31  - odd : when a new development cycle starts after a release
32 3. patch:
33  - when a development snapshot or release update becomes available
34  - all these are announced on lustre-devel@lists.sf.net
35 4. test: 
36  - when developers feel it is time to exchange a named version
37
38 What will run, what won't ? 
39 ---------------------------
40
41 1. If the test level is non-zero no guarantees of any kind are made. 
42
43 2. For three digit releases/tags the code should perform 
44    according to the announcement.
45
46 Moving tags
47 -----------
48
49 The last stable release will be tagged:            CVS tag "stable"
50 The last operational development snapshot will be  CVS tag "dstable"
51
52 Branches
53 --------
54
55 For even minor releases a branch tag will be created.  The branch tag
56 will be of the form: 
57
58 bmajor_minor
59
60 Note that the CVS head is where development is going.  If developers
61 use a branch they must eventually merge that back into the head.
62 Typically this is done by importing changes into the branch and
63 removing the sticky tags:
64
65 cvs update -A
66
67 fixing any conflicts and then committing.