Prepare version 0.7.15telepathy-glib-0.7.15

Signed-Off-By: Sjoerd Simons <sjoerd.simons@collabora.co.uk>

9 files changed, 98 insertions, 37 deletions

diff --git a/NEWS b/NEWS
index 0fd97072a..ad31172fc 100644
--- a/NEWS
+++ b/NEWS
@@ -1,22 +1,26 @@
-telepathy-glib 0.7.15 (UNRELEASED)
+telepathy-glib 0.7.15 (2008-09-18)
 ==================================
 
+The "plumbing" release.
+
 Dependencies:
 
 * GLib and GObject must be at least version 2.16 (this was accidentally the
   case in 0.7.14 too, but the dependency is now official). (fd.o #17213)
 
-Enhancements:
+Deprecations:
 
-* telepathy-glib-uninstalled.pc is generated in source builds. It's now
-  easier to compile dependent projects against an uninstalled copy of
-  telepathy-glib >= 0.7.15, like this:
+* TpBaseConnection implementations should use the new method
+  tp_base_connection_set_self_handle instead of setting the self_handle member
+  directly. To comply with spec 0.17.10, if the self-handle changes after the
+  status becomes CONNECTED, tp_base_connection_set_self_handle *must* be used.
 
-  PKG_CONFIG_PATH=$HOME/src/telepathy-glib/telepathy-glib ./autogen.sh
+Enhancements:
 
-  (if $HOME/src/telepathy-glib is the directory containing this file)
+* Updated to specification 0.17.10, which includes the SelfHandleChanged signal
+  and SelfHandle property...
 
-* Updated to specification 0.17.11, which includes the undrafted Requests
+* ... and then to specification 0.17.11, which includes the stable Requests
   interface with the CreateChannel method (but not EnsureChannel, which is
   planned for a future spec.).
 
@@ -24,6 +28,20 @@ Enhancements:
   interfaces TpChannelManager and TpExportableChannel (which are intended to
   replace TpChannelFactoryIface and TpChannelIface).
 
+* Added some utility functions: tp_dbus_properties_mixin_make_properties_hash,
+  tp_strv_contains
+
+* with-session-bus.sh (used for the tests) optionally records dbus-monitor
+  output
+
+* telepathy-glib-uninstalled.pc is generated in source builds. It's now
+  easier to compile dependent projects against an uninstalled copy of
+  telepathy-glib >= 0.7.15, like this:
+
+  PKG_CONFIG_PATH=$HOME/src/telepathy-glib/telepathy-glib ./autogen.sh
+
+  (if $HOME/src/telepathy-glib is the directory containing this file)
+
 Fixes:
 
 * TP_BASE_CONNECTION_ERROR_IF_NOT_CONNECTED no longer causes compiler warnings
@@ -37,6 +55,9 @@ Release notes for projects using code generation:
   code generation for unsigned 64-bit integer arguments. This will cause your
   project to require telepathy-glib >= 0.7.3
 
+* If you use a copy of with-session-bus.sh for regression tests, consider
+  updating it to add support for logging dbus-monitor
+
 telepathy-glib 0.7.14 (2008-08-19)
 ==================================
 
diff --git a/configure.ac b/configure.ac
index 10a6d4a33..593eaf425 100644
--- a/configure.ac
+++ b/configure.ac
@@ -11,8 +11,8 @@ AC_PREREQ([2.59])
 
 m4_define([tp_glib_major_version], [0])
 m4_define([tp_glib_minor_version], [7])
-m4_define([tp_glib_micro_version], [14])
-m4_define([tp_glib_nano_version], [1])
+m4_define([tp_glib_micro_version], [15])
+m4_define([tp_glib_nano_version], [0])
 
 # If library source has changed since last release, increment revision
 # If interfaces have been added, removed or changed since last release,
@@ -26,9 +26,9 @@ m4_define([tp_glib_nano_version], [1])
 # (we don't guarantee that we won't add ABI then remove it again, if it was
 # never seen in a release).
 
-m4_define([tp_glib_lt_current], [15])
+m4_define([tp_glib_lt_current], [16])
 m4_define([tp_glib_lt_revision], [0])
-m4_define([tp_glib_lt_age], [15])
+m4_define([tp_glib_lt_age], [16])
 
 # Some magic
 m4_define([tp_glib_base_version],
diff --git a/telepathy-glib/Makefile.am b/telepathy-glib/Makefile.am
index e2e60cb5d..ae2993e50 100644
--- a/telepathy-glib/Makefile.am
+++ b/telepathy-glib/Makefile.am
@@ -17,7 +17,8 @@ ABI_LISTS = \
     versions/0.7.10.abi \
     versions/0.7.12.abi \
     versions/0.7.13.abi \
-    versions/0.7.14.abi
+    versions/0.7.14.abi \
+    versions/0.7.15.abi
 
 EXTRA_DIST = \
     $(ABI_LISTS) \
diff --git a/telepathy-glib/base-connection.c b/telepathy-glib/base-connection.c
index a5e81464d..3ffd906dc 100644
--- a/telepathy-glib/base-connection.c
+++ b/telepathy-glib/base-connection.c
@@ -160,7 +160,7 @@
  * @create_channel_managers: Create an array of channel managers for this
  *  Connection. At least one of this or @create_channel_factories must be set
  *  by subclasses to a non-%NULL value.
- *  Since: 0.7.UNRELEASED
+ *  Since: 0.7.15
  *
  * The class of a #TpBaseConnection. Many members are virtual methods etc.
  * to be filled in in the subclass' class_init function.
@@ -195,7 +195,7 @@
  *  subclasses: use tp_base_connection_change_status() to set it.
  * @self_handle: The handle of type %TP_HANDLE_TYPE_CONTACT representing the
  *  local user. Must be set nonzero by the subclass before moving to state
- *  CONNECTED. Since 0.7.UNRELEASED, setting this property directly is
+ *  CONNECTED. Since 0.7.15, setting this property directly is
  *  deprecated, in favour of tp_base_connection_set_self_handle(); if this
  *  property is set directly, the connection must ensure it holds a reference
  *  to the handle. Changing this property directly having moved to state
@@ -217,7 +217,7 @@
  * An iterator over the #TpChannelManager objects known to a #TpBaseConnection.
  * It has no public fields.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 
 /**
@@ -1293,7 +1293,7 @@ tp_base_connection_class_init (TpBaseConnectionClass *klass)
    * The handle of type %TP_HANDLE_TYPE_CONTACT representing the local user.
    * Must be set nonzero by the subclass before moving to state CONNECTED.
    *
-   * Since: 0.7.UNRELEASED
+   * Since: 0.7.15
    */
   param_spec = g_param_spec_uint ("self-handle",
       "Connection.SelfHandle",
@@ -2330,7 +2330,7 @@ tp_base_connection_get_handles (TpBaseConnection *self,
  *
  * Returns: the current self handle of the connection.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 TpHandle
 tp_base_connection_get_self_handle (TpBaseConnection *self)
@@ -2346,7 +2346,7 @@ tp_base_connection_get_self_handle (TpBaseConnection *self)
  * Sets the #TpBaseConnection:self-handle property.  self_handle may not be 0
  * once the connection has moved to the CONNECTED state.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_base_connection_set_self_handle (TpBaseConnection *self,
@@ -2985,7 +2985,7 @@ requests_iface_init (gpointer g_iface,
  *   }
  * </programlisting></informalexample>
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_base_connection_channel_manager_iter_init (TpChannelManagerIter *iter,
@@ -3007,7 +3007,7 @@ tp_base_connection_channel_manager_iter_init (TpChannelManagerIter *iter,
  *
  * Returns: %FALSE if there are no more channel managers; else %TRUE.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 gboolean
 tp_base_connection_channel_manager_iter_next (TpChannelManagerIter *iter,
diff --git a/telepathy-glib/channel-factory-iface.c b/telepathy-glib/channel-factory-iface.c
index c7bf6c4dd..5195473db 100644
--- a/telepathy-glib/channel-factory-iface.c
+++ b/telepathy-glib/channel-factory-iface.c
@@ -35,7 +35,7 @@
  * multiple channel factories handling different types of channel.
  *
  * #TpChannelManager is a newer interface (introduced in telepathy-glib
- * 0.7.UNRELEASED) for allocating and tracking channels which supports the
+ * 0.7.15) for allocating and tracking channels which supports the
  * Requests D-Bus interface introduced in version 0.17.11 of the
  * specification.  New connection managers should implement that interface
  * instead, and existing connection managers should migrate to it.
diff --git a/telepathy-glib/channel-manager.c b/telepathy-glib/channel-manager.c
index 57554009e..2e2d92370 100644
--- a/telepathy-glib/channel-manager.c
+++ b/telepathy-glib/channel-manager.c
@@ -45,7 +45,7 @@
  * multi-user chat rooms, the index of chat rooms and MUC tubes, a media
  * channel manager which handles VoIP calls, and a 1-1 tubes channel manager.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 
 /**
@@ -318,7 +318,7 @@ tp_channel_manager_get_type (void)
  * If @channels is non-empty, emit the #TpChannelManager::new-channels
  * signal indicating that those channels have been created.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_emit_new_channels (gpointer instance,
@@ -344,7 +344,7 @@ tp_channel_manager_emit_new_channels (gpointer instance,
  * channel has been created. (This is a convenient shortcut for calling
  * tp_channel_manager_emit_new_channels() with a one-entry hash table.)
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_emit_new_channel (gpointer instance,
@@ -372,7 +372,7 @@ tp_channel_manager_emit_new_channel (gpointer instance,
  * Emit the #TpChannelManager::channel-closed signal indicating that
  * the channel at the given object path has been closed.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_emit_channel_closed (gpointer instance,
@@ -395,7 +395,7 @@ tp_channel_manager_emit_channel_closed (gpointer instance,
  * calling tp_channel_manager_emit_channel_closed() with the
  * #TpExportableChannel:object-path property of @channel.)
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_emit_channel_closed_for_object (gpointer instance,
@@ -422,7 +422,7 @@ tp_channel_manager_emit_channel_closed_for_object (gpointer instance,
  * Emit the #TpChannelManager::request-already-satisfied signal indicating
  * that the pre-existing channel @channel satisfies @request_token.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_emit_request_already_satisfied (gpointer instance,
@@ -448,7 +448,7 @@ tp_channel_manager_emit_request_already_satisfied (gpointer instance,
  * Emit the #TpChannelManager::request-failed signal indicating that
  * the request @request_token failed for the given reason.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_emit_request_failed (gpointer instance,
@@ -476,7 +476,7 @@ tp_channel_manager_emit_request_failed (gpointer instance,
  * Emit the #TpChannelManager::request-failed signal indicating that
  * the request @request_token failed for the given reason.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_emit_request_failed_printf (gpointer instance,
@@ -511,7 +511,7 @@ tp_channel_manager_emit_request_failed_printf (gpointer instance,
  *
  * Calls func(channel, user_data) for each channel managed by @manager.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_foreach_channel (TpChannelManager *manager,
@@ -539,7 +539,7 @@ tp_channel_manager_foreach_channel (TpChannelManager *manager,
  * Calls func(manager, fixed, allowed, user_data) for each channel class
  * understood by @manager.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 void
 tp_channel_manager_foreach_channel_class (TpChannelManager *manager,
@@ -571,7 +571,7 @@ tp_channel_manager_foreach_channel_class (TpChannelManager *manager,
  *
  * Returns: %TRUE if this request will be handled by @manager; else %FALSE.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 gboolean
 tp_channel_manager_create_channel (TpChannelManager *manager,
@@ -603,7 +603,7 @@ tp_channel_manager_create_channel (TpChannelManager *manager,
  *
  * Returns: %TRUE if this request will be handled by @manager; else %FALSE.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 gboolean
 tp_channel_manager_request_channel (TpChannelManager *manager,
@@ -644,7 +644,7 @@ tp_channel_manager_request_channel (TpChannelManager *manager,
  * Returns: %TRUE if all of the keys of @properties are elements of @fixed or
  *          @allowed; else %FALSE.
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 gboolean
 tp_channel_manager_asv_has_unknown_properties (GHashTable *properties,
diff --git a/telepathy-glib/dbus-properties-mixin.c b/telepathy-glib/dbus-properties-mixin.c
index 75eb45256..5ca5fbf15 100644
--- a/telepathy-glib/dbus-properties-mixin.c
+++ b/telepathy-glib/dbus-properties-mixin.c
@@ -538,7 +538,7 @@ out:
  * which means that only interfaces whose properties are set up using
  * tp_dbus_properties_mixin_implement_interface() will be used.
  *
- * Changed in 0.7.UNRELEASED: @offset may now be 0, in which case the
+ * Changed in 0.7.15: @offset may now be 0, in which case the
  * #TpDBusPropertiesMixinClass can be omitted from @cls.  It is treated as if
  * it were present, but with all fields (including
  * TpDBusPropertiesMixinClass::interfaces) being %NULL, so only interfaces
diff --git a/telepathy-glib/util.c b/telepathy-glib/util.c
index 4f70802fd..f1da86a69 100644
--- a/telepathy-glib/util.c
+++ b/telepathy-glib/util.c
@@ -309,7 +309,7 @@ tp_escape_as_identifier (const gchar *name)
  * <!-- -->
  * Returns: TRUE if @str is an element of @strv, according to strcmp().
  *
- * Since: 0.7.UNRELEASED
+ * Since: 0.7.15
  */
 gboolean
 tp_strv_contains (const gchar * const *strv,
diff --git a/telepathy-glib/versions/0.7.15.abi b/telepathy-glib/versions/0.7.15.abi
new file mode 100644
index 000000000..402bc1ccd
--- /dev/null
+++ b/telepathy-glib/versions/0.7.15.abi
@@ -0,0 +1,39 @@
+Version: TELEPATHY_GLIB_0.7.15
+Extends: TELEPATHY_GLIB_0.7.14
+Release: 0.7.15
+
+tp_base_connection_channel_manager_iter_init
+tp_base_connection_channel_manager_iter_next
+tp_base_connection_get_self_handle
+tp_base_connection_set_self_handle
+tp_channel_manager_asv_has_unknown_properties
+tp_channel_manager_create_channel
+tp_channel_manager_emit_channel_closed
+tp_channel_manager_emit_channel_closed_for_object
+tp_channel_manager_emit_new_channel
+tp_channel_manager_emit_new_channels
+tp_channel_manager_emit_request_already_satisfied
+tp_channel_manager_emit_request_failed
+tp_channel_manager_emit_request_failed_printf
+tp_channel_manager_foreach_channel
+tp_channel_manager_foreach_channel_class
+tp_channel_manager_get_type
+tp_channel_manager_request_channel
+tp_cli_connection_connect_to_self_handle_changed
+tp_cli_connection_interface_requests_call_create_channel
+tp_cli_connection_interface_requests_connect_to_channel_closed
+tp_cli_connection_interface_requests_connect_to_new_channels
+tp_cli_connection_interface_requests_run_create_channel
+tp_dbus_properties_mixin_make_properties_hash
+tp_exportable_channel_get_type
+tp_iface_quark_connection_interface_requests
+tp_strv_contains
+tp_svc_connection_emit_self_handle_changed
+tp_svc_connection_interface_requests_emit_channel_closed
+tp_svc_connection_interface_requests_emit_new_channels
+tp_svc_connection_interface_requests_get_type
+tp_svc_connection_interface_requests_implement_create_channel
+tp_type_dbus_array_a_7bsv_7das
+tp_type_dbus_array_oa_7bsv_7d
+tp_type_dbus_struct_a_7bsv_7das
+tp_type_dbus_struct_oa_7bsv_7d