summaryrefslogtreecommitdiff
path: root/telepathy-glib/extra-gtkdoc.h
diff options
context:
space:
mode:
authorWill Thompson <will.thompson@collabora.co.uk>2011-10-10 17:58:11 +0100
committerWill Thompson <will.thompson@collabora.co.uk>2011-10-10 17:58:11 +0100
commit87e6f6379f8007f8f9acbc2795f3cf8f0aa1d8c4 (patch)
tree129222492e658fcb39aa4f8be9ad4f06fdad94c1 /telepathy-glib/extra-gtkdoc.h
parente0a7a0722c688aa30b120499d84b3feec1e78479 (diff)
downloadtelepathy-glib-87e6f6379f8007f8f9acbc2795f3cf8f0aa1d8c4.tar.gz
Generate code for Room, RoomConfig and Subject
Diffstat (limited to 'telepathy-glib/extra-gtkdoc.h')
-rw-r--r--telepathy-glib/extra-gtkdoc.h58
1 files changed, 58 insertions, 0 deletions
diff --git a/telepathy-glib/extra-gtkdoc.h b/telepathy-glib/extra-gtkdoc.h
index 9f04fefdd..b6e7ed0e6 100644
--- a/telepathy-glib/extra-gtkdoc.h
+++ b/telepathy-glib/extra-gtkdoc.h
@@ -96,6 +96,37 @@
*/
/**
+ * SECTION:svc-channel-room
+ * @title: Service-side room interfaces
+ * @short_description: room-related functionality for channels
+ *
+ * This collection of interfaces is used to expose various aspects of the
+ * configuration of chat rooms.
+ *
+ * #TpSvcChannelInterfaceRoom consists only of a pair of requestable, immutable
+ * properties: <code>"RoomName"</code> and <code>"Server"</code>. It has no
+ * methods or signals. It should be implemented on channels representing a chat
+ * room (whether it be a text chat, a multi-user call, or some other media
+ * type).
+ *
+ * #TpSvcChannelInterfaceSubject may be implemented by channels which have a
+ * subject (or topic, depending on your protocol's terminology of choice). This
+ * will usually be in addition to #TpSvcChannelInterfaceRoom, though in theory
+ * a 1-1 channel could have a subject. In addition to its single method, it
+ * defines a set of read-only properties, namely <code>"Subject"</code>,
+ * <code>"Actor"</code>, <code>"ActorHandle"</code>, <code>"Timestamp"</code>,
+ * and <code>"CanSet"</code>. Changes should be signalled using
+ * tp_dbus_properties_mixin_emit_properties_changed().
+ *
+ * #TpSvcChannelInterfaceRoomConfig provides a vast array of properties for
+ * other aspects of a chat room's configuration (such as the maximum number of
+ * participants, and whether the room is password-protected). Channels with
+ * this interface will typically implement the other two, too.
+ *
+ * Since: 0.UNRELEASED
+ */
+
+/**
* SECTION:svc-channel-text
* @title: Text channels
* @short_description: service-side interfaces for the Text channel type, and
@@ -453,6 +484,33 @@
*/
/**
+ * SECTION:channel-room
+ * @title: Room-related interfaces on Channels
+ * @short_description: client-side wrappers for Room, RoomConfig and Subject
+ *
+ * This family of interfaces exposes aspects of chat rooms' configuration, and
+ * provides API to modify it (where permitted). Most of the API is in terms of
+ * D-Bus properties; they may be retrieved using
+ * tp_cli_dbus_properties_call_get_all(), and changes monitored using
+ * tp_cli_dbus_properties_connect_to_properties_changed().
+ *
+ * #TP_IFACE_CHANNEL_INTERFACE_ROOM consists only of a pair of requestable,
+ * immutable properties: #TP_PROP_CHANNEL_INTERFACE_ROOM_ROOM_NAME and
+ * #TP_PROP_CHANNEL_INTERFACE_ROOM_SERVER.
+ *
+ * In addition to #TP_IFACE_CHANNEL_INTERFACE_SUBJECT's single method, it
+ * defines a set of read-only properties: <code>"Subject"</code>,
+ * <code>"Actor"</code>, <code>"ActorHandle"</code>, <code>"Timestamp"</code>,
+ * and <code>"CanSet"</code>.
+ *
+ * #TP_IFACE_CHANNEL_INTERFACE_ROOM_CONFIG provides a vast array of properties
+ * for other aspects of a chat room's configuration (such as the maximum number
+ * of participants, and whether the room is password-protected).
+ *
+ * Since: 0.UNRELEASED
+ */
+
+/**
* SECTION:channel-text
* @title: Text channels
* @short_description: client-side wrappers for the Text channel type, and