aboutsummaryrefslogtreecommitdiffstats
path: root/TODO-RELEASE
blob: dcac95a4d49cd89eb70de8e8b623ae18c02e6807 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# When cleaning up this file upon a release:
#
# - Note that the release version number is entirely unrelated to the API
#   versions. A release version 5.2.3 may happily have an API version of 42:7:5.
#
# - Bump API version in src/lib*/Makefile.am files according to chapter
#   "Library interface versions" of the libtool documentation.
#   https://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html
#
# - Iff the 'current' API version has changed, rename debian/lib*.install and adjust debian/control accordingly
#
# API version bumping for the impatient:
# LIBVERSION=c:r:a  (current:revision_of_current:backwards_compat_age)
# 5:2:4 means that
# - this implements version 5 of the API;
# - this is the 2nd (compatible) revision of API version 5;
# - this is backwards compatible to all APIs since 4 versions ago,
#   i.e. callers that need API versions from 1 to 5 can use this.
#
# Bumping API versions recipe:
# If the library source code has changed at all since the last update, r++;
# If any interfaces have been added, removed, or changed since the last update, c++, r=0;
# If any interfaces have been added since the last public release, a++;
# If any interfaces have been removed or changed since the last public release, a=0.
#
#library	what		description / commit summary line