xref: /freebsd/contrib/ntp/packageinfo.sh (revision e0649a35a670c4b625d1de289b3886d9b3c9654f)
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 proceed from  a -stable RC to the release set rcpoint=GO
37#
38# To skip all -stable prereleases and move from one primary or point
39#   release directly to the next point release, set rcpoint=GO.
40#
41##
42#
43# To see what UpdatePoint will do without modifying packageinfo.sh as it
44# does by default, use the -t/--test option before the repo type:
45#
46# shell# scripts/build/UpdatePoint -t stable
47#
48
49# repotype must be stable or dev
50repotype=stable
51
52# post-4.2.8:
53# version=Major.Minor
54# 4.2.8 and before:
55# version=Protocol.Major.Minor
56# odd minor numbers are for -dev, even minor numbers are for -stable
57# UpdatePoint will fail if repotype is inconsistent with minor.
58proto=4
59major=2
60minor=8
61
62case "${proto}.${major}" in
63 4.[012])
64    version=${proto}.${major}.${minor}
65    ;;
66 *) version=${major}.${minor}
67    ;;
68esac
69
70# Special.  Normally unused.  A suffix.
71#special=ag
72special=
73
74# prerelease can be empty, 'beta', or 'rc'.
75prerelease=
76
77# ChangeLog starting tag (see also CommitLog-4.1.0)
78CLTAG=NTP_4_2_0
79
80### post-4.2.8:
81### Point number, after "major.minor.", normally modified by script.
82### 4.2.8 and before:
83### Point number, after "p", normally modified by script.
84# 3 cases:
85# - Numeric values increment
86# - empty 'increments' to 1
87# - NEW 'increments' to empty
88point=18
89
90### betapoint is normally modified by script.
91# ntp-stable Beta number (betapoint)
92# Should be zeroed at release, and left at zero until first beta.
93# The first beta is -beta1.
94# betapoint is always zero in ntp-dev.
95betapoint=
96
97### rcpoint is normally modified by script except for GO.
98# RC number (rcpoint)
99# for ntp-dev, always empty as RC numbers are not used, nor is GO.
100# For ntp-stable:
101# if prerelease is 'rc':
102# - Numeric values increment
103# - GO triggers a release
104# - - rcpoint is emptied
105# - - betapoint is set to 0
106# - - prerelease is emptied
107# else (not in RC)
108# - rcpoint is empty and unused (for now).
109rcpoint=
110