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.