[cairo-commit] libsvg ChangeLog, 1.56, 1.57 Makefile.am, 1.2, 1.3 NEWS, 1.1.1.1, 1.2 RELEASING, NONE, 1.1 configure.in, 1.6, 1.7

Carl Worth commit at pdx.freedesktop.org
Sun Feb 13 05:23:30 PST 2005


Committed by: cworth

Update of /cvs/cairo/libsvg
In directory gabe:/tmp/cvs-serv9385

Modified Files:
	ChangeLog Makefile.am NEWS configure.in 
Added Files:
	RELEASING 
Log Message:

        * NEWS: Add notes for 0.1.3 snapshot.

        * configure.in: Increment LIBSVG_VERSION to 0.1.3.

        * Makefile.am (release-publish): Add targets for easier creation
        of snapshots.

        * RELEASING: Add instructions on how to create a snapshot.


Index: ChangeLog
===================================================================
RCS file: /cvs/cairo/libsvg/ChangeLog,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -d -r1.56 -r1.57
--- ChangeLog	21 Jan 2005 12:54:36 -0000	1.56
+++ ChangeLog	13 Feb 2005 13:23:28 -0000	1.57
@@ -1,3 +1,14 @@
+2005-02-13  Carl Worth  <cworth at cworth.org>
+
+	* NEWS: Add notes for 0.1.3 snapshot.
+
+	* configure.in: Increment LIBSVG_VERSION to 0.1.3.
+
+	* Makefile.am (release-publish): Add targets for easier creation
+	of snapshots.
+
+	* RELEASING: Add instructions on how to create a snapshot.
+
 2005-01-21  Carl Worth  <cworth at cworth.org>
 
 	* src/svg_str.c (_svg_str_parse_all_csv_doubles): Fix segfault bug

Index: Makefile.am
===================================================================
RCS file: /cvs/cairo/libsvg/Makefile.am,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- Makefile.am	30 Oct 2003 20:53:24 -0000	1.2
+++ Makefile.am	13 Feb 2005 13:23:28 -0000	1.3
@@ -7,3 +7,53 @@
 pkgconfigdir = $(libdir)/pkgconfig
 pkgconfig_DATA = libsvg.pc
 
+# Some custom targets to make it easier to release things.
+# Use either:
+#		make release-check
+# or		make release-publish
+
+RELEASE_UPLOAD_HOST =   cairographics.org
+RELEASE_UPLOAD_DIR =    /srv/cairo.freedesktop.org/www/snapshots
+RELEASE_URL_BASE = 	http://cairographics.org/snapshots
+RELEASE_ANNOUNCE_LIST = cairo-announce at cairographics.org
+
+tar_file = $(PACKAGE)-$(VERSION).tar.gz
+md5_file = $(tar_file).md5
+
+$(md5_file): $(tar_file)
+	md5sum $^ > $@
+
+release-remove-old:
+	rm -f $(tar_file) $(md5_file)
+
+release-check: release-remove-old distcheck $(md5_file)
+
+release-verify-newer:
+	@echo -n "Checking that no $(VERSION) release already exists..."
+	@ssh $(RELEASE_UPLOAD_HOST) test ! -e $(RELEASE_UPLOAD_DIR)/$(tar_file) \
+		|| (echo "Ouch." && echo "Found: $(RELEASE_UPLOAD_HOST):$(RELEASE_UPLOAD_DIR)/$(tar_file)" \
+		&& echo "The version in configure.in must be incremented before a new release." \
+		&& false)
+	@echo "Good."
+
+release-publish: release-verify-newer release-check
+	mkdir -p releases
+	scp $(tar_file) $(md5_file) $(RELEASE_UPLOAD_HOST):$(RELEASE_UPLOAD_DIR)
+	mv $(tar_file) $(md5_file) releases
+	ssh $(RELEASE_UPLOAD_HOST) "rm -f $(RELEASE_UPLOAD_DIR)/LATEST-$(PACKAGE)-[0-9]* && touch $(RELEASE_UPLOAD_DIR)/LATEST-$(PACKAGE)-$(VERSION)"
+	@echo ""
+	@echo "Please send an announcement to $(RELEASE_ANNOUNCE_LIST)"
+	@echo "including the following:"
+	@echo ""
+	@echo "Subject: $(PACKAGE) snapshot $(VERSION) now available"
+	@echo ""
+	@echo "A new $(PACKAGE) snapshot $(VERSION) is now available from:"
+	@echo ""
+	@echo "	$(RELEASE_URL_BASE)/$(tar_file)"
+	@echo "	$(RELEASE_URL_BASE)/$(md5_file)"
+	@echo -n "	"
+	@cat releases/$(md5_file)
+	@echo ""
+	@echo "Also, please include the new entries from the NEWS file."
+
+

Index: NEWS
===================================================================
RCS file: /cvs/cairo/libsvg/NEWS,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -u -d -r1.1.1.1 -r1.2
--- NEWS	23 Oct 2002 21:19:43 -0000	1.1.1.1
+++ NEWS	13 Feb 2005 13:23:28 -0000	1.2
@@ -1,3 +1,14 @@
+Snapshot 0.1.3 (2005-01-21 Carl Worth <cworth at cworth.org>)
+==========================================================
+Add extern "C" stuff to svg.h for easier use from C++.
+
+Add whitespace compaction following the specification for
+xml:space="default".
+
+Various minor bug fixes.
+
+Initial version of libsvg
+=========================
 
 - Rewrote everything as libsvg, independent of libart, glib, pango, etc.
 

--- NEW FILE: RELEASING ---
So far, libsvg 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 libsvg

   But it's probably good enough if "cvs -q update -Ad" generates no
   output.

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:

	================================================
	libsvg-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. Take special care to note any
	incompatible changes in the API. These should be easy to find
	by looking for svg.h in the ChangeLog. Additionally, the
	output of the following command should be examined using the
	previous snapshot tag:

		cvs diff -r SNAPSHOT_X_Y_Z src/svg.h

4) Increment LIBSVG_VERSION in configure.in

	First, remove the "-head" suffix, then increment the version
	as follows:

	If there are backward-incompatible changes in the API,
	(function removals, or semantic changes), increment the minor
	number and reset the sub-minor number to 0.

	Otherwise, (that is, if there are only bug fixes and perhaps
	API additions), then increment only the sub-minor number.

	Prior to the initial "1.0" release of libsvg, leave the major
	number at 0. Also, do not modify the "libtool shared library
	version" variables, (LT_CURRENT, LT_VERSION, LT_AGE).

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:

	* Check that no release exists with the current version
	* Verify that make distcheck completes successfully
	* Generate the final tar file
	* Generate an md5sum file
	* scp both files to appear on http://cairographics.org/snapshots
	* Create a LATEST-package-version file (after deleting any old one)
	* Place local copies of both files in the releases directory
	* Provide some text for the release announcement (see below).

7) Tag the entire source tree with a tag of the form SNAPSHOT_X_Y_Z:

	cvs tag SNAPSHOT_X_Y_Z

8) Add a "-head" to LIBSVG_VERSION in configure, and commit.

9) Send a message to cairo-announce at cairographics.org to announce the
   new snapshot using the text provided from "make release-publish".


Index: configure.in
===================================================================
RCS file: /cvs/cairo/libsvg/configure.in,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- configure.in	15 Nov 2003 15:48:50 -0000	1.6
+++ configure.in	13 Feb 2005 13:23:28 -0000	1.7
@@ -3,7 +3,7 @@
 dnl ===========================================================================
 
 # Package version number, (as distinct from shared library version)
-LIBSVG_VERSION=0.1.2
+LIBSVG_VERSION=0.1.3
 
 # libtool shared library version
 




More information about the cairo-commit mailing list