summaryrefslogtreecommitdiff
path: root/pixman/RELEASING
diff options
context:
space:
mode:
authorCarl Worth <cworth@cworth.org>2004-10-27 09:37:34 +0000
committerCarl Worth <cworth@cworth.org>2004-10-27 09:37:34 +0000
commited1ad714174abd3354d2dc3991b596d83f6330bf (patch)
tree3e0a67c744f461f28a60ca5dec651e8c2b664bb6 /pixman/RELEASING
parent19d3fc2399a05a3802b1cb2ced55139fa85a68b8 (diff)
Update date since 0.1.2 release didn't get pushed out until today.
Update release instructions to include new release-publish target. Add release-check and release-publish targets to simplify the release process.
Diffstat (limited to 'pixman/RELEASING')
-rw-r--r--pixman/RELEASING57
1 files changed, 23 insertions, 34 deletions
diff --git a/pixman/RELEASING b/pixman/RELEASING
index 88077f30..cb9d4160 100644
--- a/pixman/RELEASING
+++ b/pixman/RELEASING
@@ -2,16 +2,13 @@ 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.
-10 easy steps to creating a new libpixman snapshot
-==================================================
+A new snapshot is needed whenever significant new features or bug
+fixes are committed. Here are the steps to follow:
-1) Commit code with a significant new feature or backwards
- incompatibility.
+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:
- Either of these events triggers the need for a new snapshot.
- Users of libpixman snapshots need to be able to specify snapshot
- version numbers in order to get access to a specific set of
- features.
+ cvs -d cairographics.org:/cvs/cairo co libpixman
2) Verify that the code passes "make distcheck"
@@ -34,10 +31,14 @@ snapshots.
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. Until now, we've
- only incremented the sub-minor version. We'll invent rules for
- incrementing major and minor numbers when the time is right.
+ 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
@@ -45,27 +46,15 @@ snapshots.
other commit. It's especially important to mention the new
version number in the ChangeLog.
-6) Run "make distcheck" to generate the final tar file with the
- correct version number.
+6) Run "make release-publish" which will perform the following steps
+ for you:
-7) Copy the resulting tar file to the cairo snapshots distribution
- directory:
+ * 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
- scp libpixman-X.Y.Z-tar.gz cairographics.org:/home/www/cairo/snapshots
-
-8) Tag the entire source tree with a tag of the form SNAPSHOT_X_Y_Z:
-
- cvs tag SNAPSHOT_X_Y_Z
-
-9) Send a message to cairo-announce@cairographics.org to announce the
- new snapshot.
-
- The message should provide the URL for the snapshot:
-
- http://cairographics.org/snapshots/cairo-X.Y.Z.tar.gz
-
- and should also include the relevant section from the NEWS
- file.
-
-10) Sit back and relax in confidence, or alternately, brace yourself
- for a flood of new bug reports.
+7) Send a message to cairo-announce@cairographics.org to announce the
+ new snapshot using the text provided by the previous step.