summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarl Worth <cworth@cworth.org>2004-04-16 08:52:00 +0000
committerCarl Worth <cworth@cworth.org>2004-04-16 08:52:00 +0000
commitb0f8dcdc83d3487a5016d813a4ee3284784b78c1 (patch)
tree6b2387245b32c1df269e2ecd154ffafd7e7f467f
parenta8106bae111dddf240ceb071bfb686a8d3cac782 (diff)
Add RELEASING fileSNAPSHOT_0_1_1
-rw-r--r--pixman/RELEASING71
1 files changed, 71 insertions, 0 deletions
diff --git a/pixman/RELEASING b/pixman/RELEASING
new file mode 100644
index 00000000..88077f30
--- /dev/null
+++ b/pixman/RELEASING
@@ -0,0 +1,71 @@
+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
+==================================================
+
+1) Commit code with a significant new feature or backwards
+ incompatibility.
+
+ 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.
+
+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. 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.
+
+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 distcheck" to generate the final tar file with the
+ correct version number.
+
+7) Copy the resulting tar file to the cairo snapshots distribution
+ directory:
+
+ 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.