devel-versioning.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Sun, 27 Nov 2011 23:21:26 +0200
changeset 1098 db420d971363
parent 1097 6acae85ed54b
child 1099 97e0815972e0
permissions -rw-r--r--
Version in package/release name.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1032
4decc3e00bb6 Fix coding and contents.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1009
diff changeset
     1
.. -*- coding: utf-8 -*-
4decc3e00bb6 Fix coding and contents.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1009
diff changeset
     2
921
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     3
=================
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     4
 Version format.
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     5
=================
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     6
.. contents::
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     7
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
     8
Feature set versioning.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
     9
=======================
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    10
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    11
Feature set versioning pretend to show how serious changes made according to
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    12
feature availability and how compatible these versions.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    13
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    14
Marketing versioning.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    15
=====================
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    16
1007
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    17
Marketing versioning schema used for marketing, advertising, branding purpose.
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    18
It is usually inconsistent and can changed over the time.
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    19
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    20
Examples of marketing version schema:
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    21
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    22
 * Years.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    23
 * Ancient gods.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    24
 * Star/satellite/galactic names.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    25
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    26
Look thread for GDB:
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    27
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    28
  http://www.cygwin.com/ml/gdb/2007-07/msg00061.html
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    29
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    30
There discussed:
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    31
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    32
 * Is it essential to update major version if significant change made for
1097
6acae85ed54b small fix
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1059
diff changeset
    33
   licence? Answer: **NO**!
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    34
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    35
   GPLv3 is a big deal spread out over the whole GNU project, but not a big deal
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    36
   for GDB in particular.
1097
6acae85ed54b small fix
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1059
diff changeset
    37
 * Is it right follow date version schema regardless major changes? Answer:
6acae85ed54b small fix
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1059
diff changeset
    38
   **NO**!
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    39
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    40
   Many OS distribution encode year in versions but versions does not present
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    41
   featureset but package set instead.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    42
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    43
Year as version name.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    44
---------------------
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    45
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    46
If year used as version some people can decide that 2005 is too old and broken
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    47
if it used in 2007. So companies release product by leading year number. So in
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    48
2007 they release 2008 version.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    49
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    50
Version name components.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    51
========================
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    52
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    53
 * major
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    54
 * minor
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    55
 * patch (patchlevel), micro
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    56
 * rev (revision)
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    57
 * build
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    58
 * date
1007
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    59
 * hotfix, fix
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    60
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    61
Version components usually combined in such group::
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    62
1007
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    63
  major.minor.build
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    64
  major.minor.date
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    65
  major.minor.hotfix
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    66
  major.minor.hotfix.build
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    67
  major.minor.rev
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    68
  major.minor.rev.build
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    69
  major.current.age
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    70
1007
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    71
Its conventional to have at least a major and minor number.
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    72
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    73
Prefixing version with a "v" seems to be less common.
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
    74
1098
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    75
Version in package/release name.
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    76
================================
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    77
::
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    78
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    79
  PACKAGE-MAJ.MIN.FIX.tar.gz   (Common style)
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    80
  PACKAGE-MAJ.MIN.FIX.zip
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    81
  PACKAGE-MAJ.MIN.FIX-DISTROFIX.tar.gz  (Cygwin style)
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    82
  PACKAGE_EPOCH:MAJ.MIN.FIX-DISTROFIX_ARCH.deb (Debian style)
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    83
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    84
From "Debian Policy Manual"::
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    85
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    86
  Package names must consist only of lower case letters (`a-z'), digits
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    87
  (`0-9'), plus (`+') and minus (`-') signs, and periods (`.').  They
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    88
  must be at least two characters long and must start with an
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    89
  alphanumeric character.
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    90
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    91
If you look carefully there are no any ``_`` (underscore) chars!! Also ``-`` is
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    92
portable char in file name accoding to POSIX.
db420d971363 Version in package/release name.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1097
diff changeset
    93
1057
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
    94
Versioning for libraries/modules/components.
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
    95
============================================
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
    96
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    97
Major version component.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    98
------------------------
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
    99
1007
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   100
Major number change means that fundamental change made in the architecture of
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   101
the system the new version is incompatible with the old one, upgrade between
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   102
versions is non-trivial, and any dependent of the prior version will require
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   103
code changes to upgrade to the new package.
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   104
1004
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   105
Major number rare changed (this can take a lot of year).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   106
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   107
Minor version component.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   108
------------------------
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   109
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   110
Minor number change means that the new version is backward compatible with the
1007
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   111
previous version but has significant enhancements over the previous version
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   112
(like new functionality or changed UI).
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   113
1004
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   114
Functional enhancement releases. Contain new or significantly changed
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   115
functionality and/or layout.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   116
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   117
New releases are usually only published several times a year or less.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   118
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   119
Revision, micro, bugfix version component.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   120
------------------------------------------
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   121
1007
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   122
Revision number is updated whenever a bugfix or security patche is applied to
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   123
the build such that it doesn't bring a compatibility change or introduce newer
f7a62b2027ea Version components usually combined in such group.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1004
diff changeset
   124
features.
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   125
1004
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   126
Patches are released frequently (sometimes daily).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1003
diff changeset
   127
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   128
Milestone markers.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   129
------------------
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   130
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   131
 * a (alpha) means new development is complete and code checkins are frozen.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   132
   Alpha builds should work well enough to be testable.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   133
 * b (beta) means most severe bugs are fixed and end users can start trying the
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   134
   release.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   135
 * rc (release candidate) are believed to meet all of the criteria for release
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   136
   and can be installed on test instances of production systems.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   137
1057
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   138
Versioning for products.
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   139
========================
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   140
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   141
Versioning for products differ from versioning for libraries.
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   142
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   143
Product is a set of conponents fixed to some versions. Components can be
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   144
switches as written for library versioning:
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   145
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   146
 * Any fix release interchanged.
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   147
 * Any minor release interchanged starting from some minor.
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   148
 * Major release does not interchanged at all.
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   149
1058
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   150
Product update vs upgrade.
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   151
--------------------------
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   152
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   153
Product update involve:
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   154
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   155
 * Replacing product executable files, resources files.
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   156
 * Config files and user data stay unchanged.
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   157
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   158
Product update involve:
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   159
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   160
 * Replacing product executable files, resources files.
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   161
 * Config files and used data require modification and performed by upgrade
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   162
   scripts or manually by user.
cd1062303157 Product update vs upgrade.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1057
diff changeset
   163
947
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   164
Release build version data.
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   165
===========================
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   166
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   167
 * Build number.
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   168
 * Build date.
1057
8e946a8709e0 Versioning for products.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1042
diff changeset
   169
 * VCS revision.
947
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   170
 * Branch-tag used.
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   171
 * Overnight build (Y/N).
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   172
 * QA tested (Y/N).
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   173
 * QA test results (Pass/Fail).
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   174
 * Location of full logs.
1c8a139fc25d Release build version data.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 921
diff changeset
   175
1042
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   176
Stop your VCS hook to update version!
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   177
=====================================
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   178
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   179
Don't update version without human decision.
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   180
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   181
Why do not do this on success build:
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   182
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   183
 * You can have several build machine which may concurrently update version.
1097
6acae85ed54b small fix
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1059
diff changeset
   184
 * There does not exist tools for easy querying for status of build (as ok/fail,
1042
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   185
   build configuration, date, coverage, lint checks, etc).
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   186
 * Some part of development team may not have permission for bumping version and
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   187
   after build they must revert some automatically updated files.
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   188
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   189
Why do not do this from pre-/post-commit hooks:
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   190
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   191
 * Some changes can only partially introduce feature/bugfix.
dd197cbdaf21 Stop your VCS hook to update version!
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1032
diff changeset
   192
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   193
Version ordering formula.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   194
=========================
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   195
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   196
Strongly recommend:
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   197
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   198
 * Numbers are not decimal fractions. They are integers separated by delimiters.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   199
 * Only offically released versions of the program get version numbers.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   200
   Development snapshots don't. Nor do test releases.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   201
 * If the last component is zero, it may be omitted. Do not distinguish version
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   202
   X.Y from version X.Y.0.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   203
 * Avoid using anything other than numbers in version numbers.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   204
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   205
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   206
Debian version ordering formula.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   207
--------------------------------
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   208
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   209
TODO
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   210
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   211
Semver version ordering formula.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   212
--------------------------------
1059
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   213
::
948
23cb71bb2b5d Versioning formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 947
diff changeset
   214
1059
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   215
  if (A.major != B.major) return A.major > B.major;
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   216
  if (A.minor != B.minor) return A.minor > B.minor;
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   217
  if (A.patch != B.patch) return A.patch > B.patch;
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   218
  if (A.special == B.special) return 0;
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   219
  if (A.special == "") return 1;
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   220
  if (B.special == "") return -1;
d5b0b9cc4b49 Fix indent.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1058
diff changeset
   221
  return A.special > B.special;
948
23cb71bb2b5d Versioning formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 947
diff changeset
   222
949
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   223
**NOTE** Accoding to this definition 1.0.1rc1 < 1.0.1rc10 < 1.0.1rc2 which is
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   224
non meaningful.
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   225
1003
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   226
Odd/even numbering.
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   227
-------------------
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   228
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   229
Who use:
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   230
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   231
  GLib GTK+ Gimp GNOME Kaffe
4b8b3daac0db Feature set versioning. Marketing versioning. Year as version name. Version name components. Version
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 950
diff changeset
   232
1008
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   233
Forms of compatibility.
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   234
=======================
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   235
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   236
Runtime of binary compatibility mean that binary can be swaped with another
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   237
version without breaking.
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   238
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   239
Compile time or source compatibility mean that supplied header/interfaces allow
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   240
successful compiling/linking.
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   241
1009
be52d3742472 Protocol compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1008
diff changeset
   242
Examples:
1008
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   243
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   244
 * Change type of argument in method to more generic take source compatibility
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   245
   but break binary compatibility.
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   246
 * Adding new mothod to abstract class take binary compatibility but break
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   247
   compilation (unimplement method error).
4ddb673763e6 Forms of compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1007
diff changeset
   248
1009
be52d3742472 Protocol compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1008
diff changeset
   249
File format compatibility.
be52d3742472 Protocol compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1008
diff changeset
   250
be52d3742472 Protocol compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1008
diff changeset
   251
Protocol compatibility.
be52d3742472 Protocol compatibility.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1008
diff changeset
   252
949
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   253
Compatibility formula.
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   254
======================
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   255
950
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   256
Assume that app linked with new version of lib. Thus::
949
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   257
950
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   258
  is_compatible_with_old(old, new) {
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   259
    if (old.major != new.major) return 0;
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   260
    if (old.minor > new.minor) return 0;
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   261
    return 1;
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   262
  }
949
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   263
950
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   264
Assume that app linked with old version of lib. Thus::
949
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   265
950
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   266
  is_compatible_with_new(old, new) {
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   267
    if (old.major != new.major) return 0;
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   268
    return 1;
06221010c81d Fix RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 949
diff changeset
   269
  }
949
57b995de80b5 Compatibility formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 948
diff changeset
   270
921
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   271
Reference.
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   272
==========
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   273
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   274
  https://developer.mozilla.org/en/toolkit_version_format
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   275
                Toolkit version format
948
23cb71bb2b5d Versioning formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 947
diff changeset
   276
  http://apr.apache.org/versioning.html
23cb71bb2b5d Versioning formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 947
diff changeset
   277
                APR's Version Numbering
23cb71bb2b5d Versioning formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 947
diff changeset
   278
  http://semver.org/
23cb71bb2b5d Versioning formula.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 947
diff changeset
   279
                Semantic Versioning
921
c1264ffd1a37 Toolkit version format
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   280