Annotation of embedaddon/ntp/packageinfo.sh, revision 1.1

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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>