[Telepathy-commits] [telepathy-glib/master] Generate code for the File Transfer channel type

[Simon McVittie]

---
 NEWS                                       |    1 +
 docs/reference/telepathy-glib-sections.txt |   50 ++++++++++++++++++++++++++++
 telepathy-glib/channel.xml                 |    1 +
 telepathy-glib/extra-gtkdoc.h              |   19 ++++++++++
 4 files changed, 71 insertions(+), 0 deletions(-)

diff --git a/NEWS b/NEWS
index 75b7f23..4e79fab 100644
--- a/NEWS
+++ b/NEWS
@@ -10,6 +10,7 @@ Enhancements:
     for bad identifiers (fd.o #19609)
   - MediaStreamHandler has a CodecsUpdated method
   - generated methods should now have names for all "out" arguments
+  - the File Transfer channel type is now considered stable
 
 * Use tp:name-for-bindings to construct the C name for D-Bus methods etc.,
   which will result in better C function naming for future D-Bus interfaces
diff --git a/docs/reference/telepathy-glib-sections.txt b/docs/reference/telepathy-glib-sections.txt
index cf5407d..55364a6 100644
--- a/docs/reference/telepathy-glib-sections.txt
+++ b/docs/reference/telepathy-glib-sections.txt
@@ -407,6 +407,29 @@ TP_SVC_CHANNEL_INTERFACE_PASSWORD_GET_CLASS
 
 <SECTION>
 <INCLUDE>telepathy-glib/svc-channel.h</INCLUDE>
+<TITLE>svc-channel-file-transfer</TITLE>
+<FILE>svc-channel-file-transfer</FILE>
+TpSvcChannelTypeFileTransfer
+TpSvcChannelTypeFileTransferClass
+tp_svc_channel_type_file_transfer_accept_file_impl
+tp_svc_channel_type_file_transfer_emit_file_transfer_state_changed
+tp_svc_channel_type_file_transfer_emit_initial_offset_defined
+tp_svc_channel_type_file_transfer_emit_transferred_bytes_changed
+tp_svc_channel_type_file_transfer_implement_accept_file
+tp_svc_channel_type_file_transfer_implement_provide_file
+tp_svc_channel_type_file_transfer_provide_file_impl
+tp_svc_channel_type_file_transfer_return_from_accept_file
+tp_svc_channel_type_file_transfer_return_from_provide_file
+<SUBSECTION Standard>
+TP_SVC_CHANNEL_TYPE_FILE_TRANSFER
+TP_IS_SVC_CHANNEL_TYPE_FILE_TRANSFER
+TP_TYPE_SVC_CHANNEL_TYPE_FILE_TRANSFER
+tp_svc_channel_type_file_transfer_get_type
+TP_SVC_CHANNEL_TYPE_FILE_TRANSFER_GET_CLASS
+</SECTION>
+
+<SECTION>
+<INCLUDE>telepathy-glib/svc-channel.h</INCLUDE>
 <TITLE>svc-channel-tubes</TITLE>
 <FILE>svc-channel-tubes</FILE>
 <SUBSECTION>
@@ -1677,6 +1700,12 @@ NUM_TP_LOCAL_HOLD_STATE_REASONS
 TpLocalHoldStateReason
 TpRichPresenceAccessControlType
 NUM_TP_RICH_PRESENCE_ACCESS_CONTROL_TYPES
+TpFileHashType
+NUM_TP_FILE_HASH_TYPES
+TpFileTransferState
+NUM_TP_FILE_TRANSFER_STATES
+TpFileTransferStateChangeReason
+NUM_TP_FILE_TRANSFER_STATE_CHANGE_REASONS
 </SECTION>
 
 <SECTION>
@@ -1713,6 +1742,8 @@ TP_IFACE_CHANNEL
 TP_IFACE_QUARK_CHANNEL
 TP_IFACE_CHANNEL_TYPE_CONTACT_LIST
 TP_IFACE_QUARK_CHANNEL_TYPE_CONTACT_LIST
+TP_IFACE_CHANNEL_TYPE_FILE_TRANSFER
+TP_IFACE_QUARK_CHANNEL_TYPE_FILE_TRANSFER
 TP_IFACE_CHANNEL_TYPE_STREAMED_MEDIA
 TP_IFACE_QUARK_CHANNEL_TYPE_STREAMED_MEDIA
 TP_IFACE_CHANNEL_TYPE_ROOM_LIST
@@ -1759,6 +1790,7 @@ tp_iface_quark_channel_interface_media_signalling
 tp_iface_quark_channel_interface_messages
 tp_iface_quark_channel_interface_password
 tp_iface_quark_channel_type_contact_list
+tp_iface_quark_channel_type_file_transfer
 tp_iface_quark_channel_type_room_list
 tp_iface_quark_channel_type_streamed_media
 tp_iface_quark_channel_type_text
@@ -2038,6 +2070,24 @@ tp_cli_channel_interface_password_signal_callback_password_flags_changed
 </SECTION>
 
 <SECTION>
+<FILE>channel-file-transfer</FILE>
+<TITLE>channel-file-transfer</TITLE>
+<INCLUDE>telepathy-glib/channel.h</INCLUDE>
+tp_cli_channel_type_file_transfer_call_accept_file
+tp_cli_channel_type_file_transfer_call_provide_file
+tp_cli_channel_type_file_transfer_callback_for_accept_file
+tp_cli_channel_type_file_transfer_callback_for_provide_file
+tp_cli_channel_type_file_transfer_connect_to_file_transfer_state_changed
+tp_cli_channel_type_file_transfer_connect_to_initial_offset_defined
+tp_cli_channel_type_file_transfer_connect_to_transferred_bytes_changed
+tp_cli_channel_type_file_transfer_run_accept_file
+tp_cli_channel_type_file_transfer_run_provide_file
+tp_cli_channel_type_file_transfer_signal_callback_file_transfer_state_changed
+tp_cli_channel_type_file_transfer_signal_callback_initial_offset_defined
+tp_cli_channel_type_file_transfer_signal_callback_transferred_bytes_changed
+</SECTION>
+
+<SECTION>
 <FILE>channel-media</FILE>
 <TITLE>channel-media</TITLE>
 <INCLUDE>telepathy-glib/channel.h</INCLUDE>
diff --git a/telepathy-glib/channel.xml b/telepathy-glib/channel.xml
index 434e586..bc4242f 100644
--- a/telepathy-glib/channel.xml
+++ b/telepathy-glib/channel.xml
@@ -7,6 +7,7 @@
 <xi:include href="../spec/Channel.xml"/>
 
 <xi:include href="../spec/Channel_Type_Contact_List.xml"/>
+<xi:include href="../spec/Channel_Type_File_Transfer.xml"/>
 <xi:include href="../spec/Channel_Type_Streamed_Media.xml"/>
 <xi:include href="../spec/Channel_Type_Room_List.xml"/>
 <xi:include href="../spec/Channel_Type_Text.xml"/>
diff --git a/telepathy-glib/extra-gtkdoc.h b/telepathy-glib/extra-gtkdoc.h
index 208782f..aacffb4 100644
--- a/telepathy-glib/extra-gtkdoc.h
+++ b/telepathy-glib/extra-gtkdoc.h
@@ -93,6 +93,15 @@
  */
 
 /**
+ * SECTION:svc-channel-file-transfer
+ * @title: File Transfer channels
+ * @short_description: service-side interface for the File Transfer channel type
+ *
+ * This section documents the auto-generated GInterface used to implement
+ * the File Transfer channel type.
+ */
+
+/**
  * SECTION:svc-channel-media
  * @title: Media channels
  * @short_description: service-side interfaces for the Streamed Media channel
@@ -306,6 +315,16 @@
  */
 
 /**
+ * SECTION:channel-file-transfer
+ * @title: File transfer
+ * @short_description: client-side wrappers for the File Transfer channel type
+ * @see_also: #TpChannel
+ *
+ * This section documents the auto-generated C wrappers for the File Transfer
+ * channel type.
+ */
+
+/**
  * SECTION:channel-media
  * @title: Media channels
  * @short_description: client-side wrappers for the Streamed Media channel
-- 
1.5.6.5