2 # packageinfo.sh - set shell variables with version components
4 # This file is sourced by other scripts and does not need execute
5 # permission or the #! shell selector.
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.
13 # To bump the -dev point (p) number, UpdatePoint needs no changes here.
15 # To start a -RC cycle in -dev leading to the next -stable release,
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.
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.
30 # To move on from -stable beta to RC set prerelease=rc.
32 # To fall back from -stable RC to beta set prerelease=beta.
34 # To skip over -stable beta1 directly to -RC1, set prerelease=rc.
36 # To skip all -stable prereleases and move from one primary or point
37 # release directly to the next point release, set rcpoint=GO.
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:
44 # shell# scripts/build/UpdatePoint -t stable
47 # repotype must be stable or dev
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.
60 case "${proto}.${major}" in
62 version=${proto}.${major}.${minor}
64 *) version=${major}.${minor}
68 # Special. Normally unused. A suffix.
72 # prerelease can be empty, 'beta', or 'rc'.
75 # ChangeLog starting tag (see also CommitLog-4.1.0)
79 ### Point number, after "major.minor.", normally modified by script.
81 ### Point number, after "p", normally modified by script.
83 # - Numeric values increment
84 # - empty 'increments' to 1
85 # - NEW 'increments' to empty
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.
95 ### rcpoint is normally modified by script except for GO.
97 # for ntp-dev, always empty as RC numbers are not used, nor is GO.
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
106 # - rcpoint is empty and unused (for now).