xref: /freebsd/contrib/ntp/packageinfo.sh (revision 1d386b48a555f61cb7325543adbbb5c3f3407a66)
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
48repotype=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.
56proto=4
57major=2
58minor=8
59
60case "${proto}.${major}" in
61 4.[012])
62    version=${proto}.${major}.${minor}
63    ;;
64 *) version=${major}.${minor}
65    ;;
66esac
67
68# Special.  Normally unused.  A suffix.
69#special=ag
70special=
71
72# prerelease can be empty, 'beta', or 'rc'.
73prerelease=
74
75# ChangeLog starting tag (see also CommitLog-4.1.0)
76CLTAG=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
86point=17
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.
93betapoint=
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).
107rcpoint=
108