[Telepathy] merge: telepathy-gabble

[Merge Monkey]

Merge to:

  telepathy-gabble

From:

  /home/smcv/public_html/darcs/gabble-more-docs-etc-2

Changes:

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpStaticHandleRepo: finish documenting

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    util.c: keep gtkdoc happy

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    debug-ansi.h: Add trivial gtkdoc

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Fix cunning multiple-inclusion-allowed behaviour of internal-debug.h so it actually works with debugging disabled

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    errors: add gtkdoc

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Group mixin: Explain how to use it

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Move tp_error_get_type, tp_errors_quark out of API docs

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpGroupMixin: whitespace, line-wrapping, use structs rather than gpointer* (= void**) to pass user data to foreach functions

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Finish documenting TpBaseConnection. Adjust whitespace

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpGroupMixin: Switch first function argument to GObject, if CM has defined _TP_CM_UPDATED_FOR_0_5_7. Finish documenting

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpHandleRepoIface, TpHandleSet, tp_handle_type_is_valid: finish documenting

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add a trivial test for the debug infrastructure

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpTextMixin: finish documenting

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpGroupMixin: Finish documenting, add a couple of assertions and use better argument names

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    tp_connection_manager_run: document return value

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    GabbleMUCChannel: whitespace/wrapping

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    genginterface: Generate trivial gtkdoc for interface instance typedef and for interface class struct

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    group-mixin.c: make local_pending_remove_foreach static

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpPropertiesMixin: add XML comments to make gtkdoc believe I've documented functions for which Returns: is enough documentation

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Generate simple gtkdoc for TpSvc interfaces. Stop making tp_svc_connection_connect, etc. extern (only the generated glue needs to know about the method implementations).

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpGroupMixin: more whitespace

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Fix multiple-inclusion guard on internal-debug.h

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpChannelFactoryIface: Change parameter from guint to TpHandle

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Text mixin: update copyright year, explain how to use it

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpHeap: finish documenting

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Properties mixin: Fold long lines, whitespace

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Generate simple gtkdoc for interfaces and enums

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Include tp_debug_set_flags_from_string stub too, when compiling without debug

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    GabbleRoster, GabbleMediaChannel: update to GObject-based TpGroupMixin API

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    group-mixin.c: Fix migration from gpointer* to structs

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    GabbleRosterChannel: Update for GObject-based group mixin API

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Ignore telepathy-glib test executables by pattern

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpDynamicHandleRepo: finish documenting

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpChannelFactoryIface: tweak gtkdoc, whitespace

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    GabbleMUCChannel: Update to GObject-based group mixin API

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Change TpHandle from guint32 to just guint. Add TP_TYPE_HANDLE which is the GType of a TpHandle (i.e. G_TYPE_UINT).

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Properties mixin: Finish documenting

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    tp_base_connection_dbus_request_handles: Add a FIXME comment explaining that we're raising the wrong error

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TpChannelFactoryIface: whitespace/indentation