Commit Graph

28 Commits

Author SHA1 Message Date
Pekka Paalanen
bfb392e02a releasing: how to handle libweston
libweston has separate version numbering from weston because of
development needs.

During development, weston version is major.minor.90 which will never be
a release version number. While developing, we may break the libweston
backward-compatibility, in which case libweston_major_version will be
bumped. This means that libweston_major_version > weston_major_version
but only during the development period and for the pre-releases. When
the official x.y.0 release is made, weston and libweston versions will
get synchronized as explained in releasing.txt.

The reason we do this is that e.g. during the weston 3.0.90 development
period we must be able to install libweston-4.so because the development
has broken the compatibility and so we cannot install it as libweston-3.so
anymore. However, we cannot bump weston to 4.0.90, because then the
official release would go backwards in numbers to 4.0.0.

This also means that weston pre-releases major.minor.9x may install
libweston-(major+1).so. There is also libweston-(major+1).pc file but it
will give the weston version as the version number. IOW, pkg-config
check for 'libweston-M < M.0.0' matches only the pre-releases of the
libweston major version M. Hence, 'libweston-M >= M.0.0' cannot be
satisfied by pre-releases.

The weston and libweston version numbers MUST be identical in all
releases except the pre-releases major.minor.9x.

When the 1.11.91 pre-release is made, the rules imply that libweston
version will be bumped from 0.0.0 to 1.11.91. The bumping will continue
up to the 1.12.0 release. After the bump to 1.12.90, the libweston
version may be bumped to 2.0.0. Then the rules imply that:
- 1.12.9x pre-releases install libweston 2.0.0
- the next .0 release is 2.0.0 containing libweston 2.0.0

If the 1.12 stable branch will see additional releases, those will be
numbered 1.12.1, 1.12.2, etc. with the libweston version being the same
as the release version number.

If we have release 2.0.91 without libweston major bump, then libweston
version will match the release version, leading up to 2.1.0.

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
Reviewed-by: Jonas Ådahl <jadahl@gmail.com>
Reviewed-by: Quentin Glidic <sardemff7+git@sardemff7.net>
Reviewed-by: Emil Velikov <emil.velikov@collabora.com>
2016-08-15 18:07:06 +03:00
Bryce Harrington
6657fda58a releasing: Copyedit post-release branching directions 2016-06-01 17:17:57 -07:00
Bryce Harrington
7b0d18e141 releasing: Update script name 2016-05-31 15:52:33 -07:00
Bryce Harrington
f89cd51e0c releasing: Update release docs in regards to the wayland versioned dependency 2016-05-24 12:34:44 -07:00
Bryce Harrington
2f783018ff releasing: Correct documentation for script name
Signed-off-by: Bryce Harrington <bryce@osg.samsung.com>
2016-05-04 14:58:50 -07:00
Bryce Harrington
9d24f23e4d releasing.txt: Script now figures out release name on its own 2016-02-11 15:23:33 -08:00
Bryce Harrington
1abf5e43b5 releasing: register_release now inserts the email announcement urls 2016-01-20 12:37:45 -08:00
Jonas Ådahl
379ee65dc7 releasing.txt: Add step about checking wayland-protocols dependency
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
Acked-by: Bryce Harrington <bryce@osg.samsung.com>
Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2015-11-19 15:54:57 +02:00
Bryce Harrington
713acd6860 releasing: Update command path to reflect new scripts dir in wayland-web 2015-09-22 13:40:43 -07:00
Bryce Harrington
90e2d07ec1 releasing: Note need for pgp signing announcement 2015-09-17 16:33:48 -07:00
Bryce Harrington
842ef2f895 releasing: Soften suggestion to update the wayland version dependency 2015-08-16 14:16:26 -07:00
Bryce Harrington
cab7ed9fc8 releasing: Update release names 2015-08-16 14:00:05 -07:00
Bryce Harrington
9a4a47d27b releasing: Convert tabs to spacing for better formatting 2015-05-27 23:55:08 -07:00
Bryce Harrington
e534ae4778 releasing: Document usage for the new public-doc script 2015-05-27 15:33:27 -07:00
Bryce Harrington
bbdb2a9ba9 releasing: Use version number variable 2015-05-27 13:07:51 -07:00
Bryce Harrington
f89ca8c79d releasing: Add mention of the new register_release helper script 2015-05-27 13:07:47 -07:00
Bryce Harrington
4b48895841 releasing: Add vars for release name and number 2015-05-26 19:20:37 -07:00
Bryce Harrington
b33877a9cc releasing: untabify 2015-05-15 18:51:19 -07:00
Bryce Harrington
5fa7351ac6 releasing: List some lib paths to set for local libinput
These always bite me, so while probably uncommon may as well document
them...
2015-05-15 18:50:04 -07:00
Bryce Harrington
8a88cec7d4 releasing: Note that Xwayland installation required only for Weston releases 2015-02-13 20:46:41 -08:00
Bryce Harrington
a9d0b6836e releasing: Revert fix and just document work-around of Xwayland path
If Xwayland is not in /usr/bin, distcheck will fail without patch
023b265b, which propagates @XSERVER_PATH@ to distcheck but blocks other
use of the DISTCHECK_CONFIGURE_FLAGS env var.  Instead, revert the fix
and merely document the need for setting DISTCHECK_CONFIGURE_FLAGS
manually.

Revert "build:  Pass along any user-specified xserver path to distcheck"

This reverts commit 023b265b44.
2015-02-12 18:23:31 -08:00
Bryce Harrington
044f79d489 releasing: Tweak docs to better match actual workflow 2015-02-06 18:03:10 -08:00
Bryce Harrington
7154c18d76 releasing: Directions for updating the website 2015-01-30 19:10:12 -08:00
Bryce Harrington
1875affcc8 releasing: Mention dual release announcements 2015-01-26 18:23:37 -08:00
Bryce Harrington
b73c58e6d7 releasing: Add example commands to release directions
Note that for weston, configure.ac needs version numbers updated in
several places.  `make distcheck` for weston no longer triggers the test
suite to run, so update the directions to run a `make check`
pre-release.  Switch to using the X.org release.sh script in place of
some of the manual steps.

Signed-off-by: Bryce Harrington <bryce@osg.samsung.com>
Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>
2015-01-20 20:17:50 -08:00
Bryce Harrington
ae71579832 releasing: Typo
Signed-off-by: Bryce Harrington <bryce@osg.samsung.com>
Reviewed-by: Derek Foreman <derekf@osg.samsung.com>
2015-01-20 17:25:20 -08:00
Daniel Stone
16a34f1e32 releasing: update web host name
Signed-off-by: Daniel Stone <daniels@collabora.com>
2014-10-08 12:12:41 +01:00
Kristian Høgsberg
73dfbd517f Add releasing.txt to describe the release steps and other bits of process 2014-05-23 10:13:59 -07:00