[Telepathy] merge: telepathy-gabble

[Merge Monkey]

Merge to:

  telepathy-gabble

From:

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

Changes:

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    extra-gtkdoc.h: Add svc-media-interfaces SECTION.

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Correct TpBaseConnection introduction

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    dbus.c: "Document" functions with an XML comment, if the Returns: stanza is enough documentation (stops gtkdoc thinking they're undocumented).

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add SECTION blurb for handle, handle-repo-static

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add SECTION blurb for enums.h to extra-gtkdoc.h

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    handle-repo: Improve documentation slightly

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    text-mixin: Fix documentation for tp_text_mixin_init()

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add copyright to extra-gtkdoc.h

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Document that the default in TpBaseConnection is no additional interfaces

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    heap and intset: Complete documentation and "document" functions with an XML comment when the contents of Returns: is enough

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    extra-gtkdoc.h: Document interfaces, errors

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    text-mixin: complete documentation

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    extra-gtkdoc.h: it's short_description, not short-description