empathy r1397 - in trunk: docs docs/libempathy docs/libempathy-gtk libempathy

[xclaesse svn gnome org]

Author: xclaesse
Date: Thu Aug 28 09:52:21 2008
New Revision: 1397
URL: http://svn.gnome.org/viewvc/empathy?rev=1397&view=rev

Log:
Update API doc and add a README to explain how to keep it updated.

Added:
   trunk/docs/README
Modified:
   trunk/docs/libempathy-gtk/libempathy-gtk-docs.sgml
   trunk/docs/libempathy-gtk/libempathy-gtk.types
   trunk/docs/libempathy/libempathy-docs.sgml
   trunk/libempathy/empathy-irc-network-manager.h

Added: trunk/docs/README
==============================================================================
--- (empty file)
+++ trunk/docs/README	Thu Aug 28 09:52:21 2008
@@ -0,0 +1,8 @@
+To be sure the doc is up to date:
+
+1) Update libempathy.types
+empathy/libempathy$ grep _get_type *.h | grep GType | awk '{ print $2 }'
+
+2) Update libempathy-docs.sgml
+empathy$ make
+empathy/doc/libempathy$ for f in `ls -l xml/*.xml | awk '{ print $8 }'`; do echo "    <xi:include href=\"$f\"/>"; done

Modified: trunk/docs/libempathy-gtk/libempathy-gtk-docs.sgml
==============================================================================
--- trunk/docs/libempathy-gtk/libempathy-gtk-docs.sgml	(original)
+++ trunk/docs/libempathy-gtk/libempathy-gtk-docs.sgml	Thu Aug 28 09:52:21 2008
@@ -17,15 +17,16 @@
     <chapter id="libempathy_api">
       <title>libempathy-gtk API reference</title>
     <xi:include href="xml/empathy-account-chooser.xml"/>
-    <xi:include href="xml/empathy-account-widget.xml"/>
     <xi:include href="xml/empathy-account-widget-irc.xml"/>
+    <xi:include href="xml/empathy-account-widget-sip.xml"/>
+    <xi:include href="xml/empathy-account-widget.xml"/>
     <xi:include href="xml/empathy-avatar-chooser.xml"/>
     <xi:include href="xml/empathy-avatar-image.xml"/>
     <xi:include href="xml/empathy-cell-renderer-activatable.xml"/>
     <xi:include href="xml/empathy-cell-renderer-expander.xml"/>
     <xi:include href="xml/empathy-cell-renderer-text.xml"/>
-    <xi:include href="xml/empathy-chat.xml"/>
     <xi:include href="xml/empathy-chat-view.xml"/>
+    <xi:include href="xml/empathy-chat.xml"/>
     <xi:include href="xml/empathy-conf.xml"/>
     <xi:include href="xml/empathy-contact-dialogs.xml"/>
     <xi:include href="xml/empathy-contact-list-store.xml"/>
@@ -42,7 +43,10 @@
     <xi:include href="xml/empathy-smiley-manager.xml"/>
     <xi:include href="xml/empathy-spell-dialog.xml"/>
     <xi:include href="xml/empathy-spell.xml"/>
+    <xi:include href="xml/empathy-theme-boxes.xml"/>
+    <xi:include href="xml/empathy-theme-irc.xml"/>
     <xi:include href="xml/empathy-theme-manager.xml"/>
+    <xi:include href="xml/empathy-theme.xml"/>
     <xi:include href="xml/empathy-ui-utils.xml"/>
     </chapter>
   </part>

Modified: trunk/docs/libempathy-gtk/libempathy-gtk.types
==============================================================================
--- trunk/docs/libempathy-gtk/libempathy-gtk.types	(original)
+++ trunk/docs/libempathy-gtk/libempathy-gtk.types	Thu Aug 28 09:52:21 2008
@@ -6,11 +6,14 @@
 empathy_cell_renderer_text_get_type
 empathy_chat_get_type
 empathy_chat_view_get_type
+empathy_conf_get_type
 empathy_contact_list_store_get_type
 empathy_contact_list_view_get_type
-empathy_contact_widget_flags_get_type
 empathy_contact_list_store_sort_get_type
 empathy_contact_list_store_col_get_type
+empathy_contact_list_feature_flags_get_type
+empathy_contact_widget_flags_get_type
+empathy_contact_feature_flags_get_type
 empathy_presence_chooser_get_type
 empathy_smiley_manager_get_type
 empathy_theme_boxes_get_type

Modified: trunk/docs/libempathy/libempathy-docs.sgml
==============================================================================
--- trunk/docs/libempathy/libempathy-docs.sgml	(original)
+++ trunk/docs/libempathy/libempathy-docs.sgml	Thu Aug 28 09:52:21 2008
@@ -16,32 +16,31 @@
   <title>API Reference</title>
     <chapter id="libempathy_api">
       <title>libempathy API reference</title>
-      <xi:include href="xml/empathy-chatroom-manager.xml"/>
-      <xi:include href="xml/empathy-chatroom.xml"/>
-      <xi:include href="xml/empathy-contact-factory.xml"/>
-      <xi:include href="xml/empathy-contact-groups.xml"/>
-      <xi:include href="xml/empathy-contact-list.xml"/>
-      <xi:include href="xml/empathy-contact-manager.xml"/>
-      <xi:include href="xml/empathy-contact.xml"/>
-      <xi:include href="xml/empathy-dispatcher.xml"/>
-      <xi:include href="xml/empathy-enum-types.xml"/>
-      <xi:include href="xml/empathy-idle.xml"/>
-      <xi:include href="xml/empathy-irc-server.xml"/>
-      <xi:include href="xml/empathy-irc-network.xml"/>
-      <xi:include href="xml/empathy-irc-network-manager.xml"/>
-      <xi:include href="xml/empathy-log-manager.xml"/>
-      <xi:include href="xml/empathy-message.xml"/>
-      <xi:include href="xml/empathy-status-presets.xml"/>
-      <xi:include href="xml/empathy-time.xml"/>
-      <xi:include href="xml/empathy-tp-call.xml"/>
-      <xi:include href="xml/empathy-tp-chat.xml"/>
-      <xi:include href="xml/empathy-tp-contact-factory.xml"/>
-      <xi:include href="xml/empathy-tp-contact-list.xml"/>
-      <xi:include href="xml/empathy-tp-group.xml"/>
-      <xi:include href="xml/empathy-tp-roomlist.xml"/>
-      <xi:include href="xml/empathy-tp-tube.xml"/>
-      <xi:include href="xml/empathy-tube-handler.xml"/>
-      <xi:include href="xml/empathy-utils.xml"/>
+    <xi:include href="xml/empathy-chatroom-manager.xml"/>
+    <xi:include href="xml/empathy-chatroom.xml"/>
+    <xi:include href="xml/empathy-contact-factory.xml"/>
+    <xi:include href="xml/empathy-contact-groups.xml"/>
+    <xi:include href="xml/empathy-contact-list.xml"/>
+    <xi:include href="xml/empathy-contact-manager.xml"/>
+    <xi:include href="xml/empathy-contact.xml"/>
+    <xi:include href="xml/empathy-dispatcher.xml"/>
+    <xi:include href="xml/empathy-idle.xml"/>
+    <xi:include href="xml/empathy-irc-network-manager.xml"/>
+    <xi:include href="xml/empathy-irc-network.xml"/>
+    <xi:include href="xml/empathy-irc-server.xml"/>
+    <xi:include href="xml/empathy-log-manager.xml"/>
+    <xi:include href="xml/empathy-message.xml"/>
+    <xi:include href="xml/empathy-status-presets.xml"/>
+    <xi:include href="xml/empathy-time.xml"/>
+    <xi:include href="xml/empathy-tp-call.xml"/>
+    <xi:include href="xml/empathy-tp-chat.xml"/>
+    <xi:include href="xml/empathy-tp-contact-factory.xml"/>
+    <xi:include href="xml/empathy-tp-contact-list.xml"/>
+    <xi:include href="xml/empathy-tp-group.xml"/>
+    <xi:include href="xml/empathy-tp-roomlist.xml"/>
+    <xi:include href="xml/empathy-tp-tube.xml"/>
+    <xi:include href="xml/empathy-tube-handler.xml"/>
+    <xi:include href="xml/empathy-utils.xml"/>
     </chapter>
   </part>
 

Modified: trunk/libempathy/empathy-irc-network-manager.h
==============================================================================
--- trunk/libempathy/empathy-irc-network-manager.h	(original)
+++ trunk/libempathy/empathy-irc-network-manager.h	Thu Aug 28 09:52:21 2008
@@ -41,8 +41,7 @@
   GObjectClass parent_class;
 };
 
-GType
-empathy_irc_network_manager_get_type (void);
+GType empathy_irc_network_manager_get_type (void);
 
 /* TYPE MACROS */
 #define EMPATHY_TYPE_IRC_NETWORK_MANAGER \