contrib/ntp/packageinfo.sh

   1 #
   2 # packageinfo.sh - set shell variables with version components
   3 #
   4 # This file is sourced by other scripts and does not need execute
   5 # permission or the #! shell selector.
   6 #
   7 # Most changes to this file are fully or semi-automated using the
   8 #   UpdatePoint script on the ntp.org tarball build machine.  Changes
   9 #   required by the typical ntp.org release sequences are below.
  10 #
  11 ## DEV:
  12 #
  13 # To bump the -dev point (p) number, UpdatePoint needs no changes here.
  14 #
  15 # To start a -RC cycle in -dev leading to the next -stable release,
  16 #   set prerelease=rc.
  17 #
  18 # To move from dev -RC to new -stable and -dev major/minor version, set
  19 #   minor and/or major to the new version, repotype to match the new
  20 #   minor version, empty prerelease, and set point=NEW.  UpdatePoint
  21 #   will empty point and rcpoint, and set betapoint=0.
  22 #
  23 ## STABLE:
  24 #
  25 # To start a -stable beta cycle, which normally occurs before a -stable
  26 #   -RC1 during the runup to a -stable point release, UpdatePoint needs
  27 #   no changes here.  Both betapoint and point will be incremented, and
  28 #   prerelease will be set to beta.
  29 #
  30 # To move on from -stable beta to RC set prerelease=rc.
  31 #
  32 # To fall back from -stable RC to beta set prerelease=beta.
  33 #
  34 # To skip over -stable beta1 directly to -RC1, set prerelease=rc.
  35 #
  36 # To skip all -stable prereleases and move from one primary or point
  37 #   release directly to the next point release, set rcpoint=GO.
  38 #
  39 ##
  40 #
  41 # To see what UpdatePoint will do without modifying packageinfo.sh as it
  42 # does by default, use the -t/--test option before the repo type:
  43 #
  44 # shell# scripts/build/UpdatePoint -t stable
  45 #
  46
  47 # repotype must be stable or dev
  48 repotype=stable
  49
  50 # post-4.2.8:
  51 # version=Major.Minor
  52 # 4.2.8 and before:
  53 # version=Protocol.Major.Minor
  54 # odd minor numbers are for -dev, even minor numbers are for -stable
  55 # UpdatePoint will fail if repotype is inconsistent with minor.
  56 proto=4
  57 major=2
  58 minor=8
  59
  60 case "${proto}.${major}" in
  61  4.[012])
  62     version=${proto}.${major}.${minor}
  63     ;;
  64  *) version=${major}.${minor}
  65     ;;
  66 esac
  67
  68 # Special.  Normally unused.  A suffix.
  69 #special=ag
  70 special=
  71
  72 # prerelease can be empty, 'beta', or 'rc'.
  73 prerelease=
  74
  75 # ChangeLog starting tag (see also CommitLog-4.1.0)
  76 CLTAG=NTP_4_2_0
  77
  78 ### post-4.2.8:
  79 ### Point number, after "major.minor.", normally modified by script.
  80 ### 4.2.8 and before:
  81 ### Point number, after "p", normally modified by script.
  82 # 3 cases:
  83 # - Numeric values increment
  84 # - empty 'increments' to 1
  85 # - NEW 'increments' to empty
  86 point=7
  87
  88 ### betapoint is normally modified by script.
  89 # ntp-stable Beta number (betapoint)
  90 # Should be zeroed at release, and left at zero until first beta.
  91 # The first beta is -beta1.
  92 # betapoint is always zero in ntp-dev.
  93 betapoint=0
  94
  95 ### rcpoint is normally modified by script except for GO.
  96 # RC number (rcpoint)
  97 # for ntp-dev, always empty as RC numbers are not used, nor is GO.
  98 # For ntp-stable:
  99 # if prerelease is 'rc':
 100 # - Numeric values increment
 101 # - GO triggers a release
 102 # - - rcpoint is emptied
 103 # - - betapoint is set to 0
 104 # - - prerelease is emptied
 105 # else (not in RC)
 106 # - rcpoint is empty and unused (for now).
 107 rcpoint=