summaryrefslogtreecommitdiff
path: root/telepathy-glib/automatic-proxy-factory.c
diff options
context:
space:
mode:
authorGuillaume Desmottes <guillaume.desmottes@collabora.co.uk>2010-10-11 10:56:39 +0200
committerGuillaume Desmottes <guillaume.desmottes@collabora.co.uk>2010-10-11 11:21:56 +0200
commite7e082d431f1b9a8592903bb803be570b3528458 (patch)
tree0b5638926dab91367a7751a38458b5a15b750fc2 /telepathy-glib/automatic-proxy-factory.c
parent91c642269ef5b5c18d82033af0f03d8b72ae7dc8 (diff)
downloadtelepathy-glib-e7e082d431f1b9a8592903bb803be570b3528458.tar.gz
improve TpAutomaticProxyFactory doc
Diffstat (limited to 'telepathy-glib/automatic-proxy-factory.c')
-rw-r--r--telepathy-glib/automatic-proxy-factory.c24
1 files changed, 19 insertions, 5 deletions
diff --git a/telepathy-glib/automatic-proxy-factory.c b/telepathy-glib/automatic-proxy-factory.c
index 0d8cdbab9..ff7b3a870 100644
--- a/telepathy-glib/automatic-proxy-factory.c
+++ b/telepathy-glib/automatic-proxy-factory.c
@@ -22,15 +22,29 @@
* SECTION:automatic-proxy-factory
* @title: TpAutomaticProxyFactory
* @short_description: factory creating higher level proxy objects
+ * @see_also: #TpBasicProxyFactory
*
* This factory implements the #TpClientChannelFactoryInterface interface to
* create specialized #TpChannel subclasses.
*
- * The current version of #TpAutomaticProxyFactory guarantees to create the
- * following objects:
- * - if channel is of type TP_IFACE_CHANNEL_TYPE_STREAM_TUBE, a
- * #TpStreamTubeChannel
- * - for all the other channel types, a #TpChannel
+ * #TpAutomaticProxyFactory will currently create #TpChannel objects
+ * as follows:
+ *
+ * <itemizedlist>
+ * <listitem>
+ * <para>a #TpStreamTubeChannel, if the channel is of type
+ * %TP_IFACE_CHANNEL_TYPE_STREAM_TUBE;</para>
+ * </listitem>
+ * <listitem>
+ * <para>a plain #TpChannel, otherwise</para>
+ * </listitem>
+ * </itemizedlist>
+ *
+ * It is guaranteed that the objects returned by future versions
+ * will be either the class that is currently used, or a more specific
+ * subclass of that class.
+ *
+ * TpProxy subclasses other than TpChannel are not currently supported.
*/
/**