summaryrefslogtreecommitdiff
path: root/pixman/RELEASING
blob: cb9d4160555f25c831cc7520870096fb8649c410 (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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
So far, libpixman hasn't reached an initial release. But we can still form
good habits now by practicing the release process with the current
snapshots.

A new snapshot is needed whenever significant new features or bug
fixes are committed. Here are the steps to follow:

1) Ensure that there are no local, uncommitted modifications. The best
   thing to do here may be to begin with a fresh checkout from CVS:

	cvs -d cairographics.org:/cvs/cairo co libpixman

2) Verify that the code passes "make distcheck"

	Running "make distcheck" should result in no warnings or
	errors and end with a message of the form:

	================================================
	libpixman-X.Y.Z.tar.gz is ready for distribution
	================================================

	(But the tar file isn't actually ready yet, as we still have
	some more steps to follow).

3) Fill out an entry in the NEWS file

	Sift through the information in ChangeLog since the last
	snapshot. Summarize major changes briefly in a style similar
	to other entries in NEWS.

4) Increment LIBPIXMAN_VERSION in configure.in

	Right now, in its pre-release form, we are incrementing
	LIBPIXMAN_VERSION for each snapshot but we are not changing
	the libtool shared library version information. Increment the
	subminor version for bug fixes and backwards-compatible
	additions to the API. Increment the minor number (and reset
	the subminor) for backward-incompatible changes to the API
	(including removals). Leave the major number at 0 until we are
	ready for the first 1.0 release, (at which point these rules
	will change).

5) Commit the changes to NEWS and configure.in

	Don't forget to fill out the ChangeLog just like with any
	other commit. It's especially important to mention the new
	version number in the ChangeLog.

6) Run "make release-publish" which will perform the following steps
   for you:

	* Verify that make distcheck completes successfully
	* Generate the final tar file with the correct version number
	* Generate an md5sum file
	* scp both files to cairographics.org:/home/www/cairo/snapshots
	* Place local copies of both files in the releases directory
	* Provide some text for the release announcement

7) Send a message to cairo-announce@cairographics.org to announce the
   new snapshot using the text provided by the previous step.