pidgin: 9df9174b: Assorted cleanups, mostly to the Doxygen...

[rlaager at pidgin.im]

-----------------------------------------------------------------
Revision: 9df9174bb1a0b9508ebd9632ea5b21b818b0f8cf
Ancestor: 29a64631ab329cc34fb0fe53bc28fede66aecda4
Author: rlaager at pidgin.im
Date: 2008-05-11T05:08:08
Branch: im.pidgin.pidgin
URL: http://d.pidgin.im/viewmtn/revision/info/9df9174bb1a0b9508ebd9632ea5b21b818b0f8cf

Modified files:
        finch/gntlog.h libpurple/blist.h libpurple/conversation.h
        libpurple/eventloop.h libpurple/prpl.h libpurple/util.h
        pidgin/gtkthemes.h

ChangeLog: 

Assorted cleanups, mostly to the Doxygen comments.  I added a few missing
@since tags.

-------------- next part --------------
============================================================
--- finch/gntlog.h	563f8e5a1f11d7209cc6f9ab9172ddd2ec96d310
+++ finch/gntlog.h	1c962537280047cbb8483db7578d0ec325c59ce5
@@ -1,7 +1,6 @@
 /**
  * @file gntlog.h GNT Log viewer
  * @ingroup finch
- * @see @ref gntlog-signals
  */
 
 /* finch
============================================================
--- libpurple/blist.h	c81af827e59257afd3a1fb730a3f9d55a8c0ae68
+++ libpurple/blist.h	9918cbe2ba1e5e51cf784d61cbdc69285305e4b7
@@ -957,6 +957,7 @@ PurpleBlistNodeFlags purple_blist_node_g
  * @param node The node.
  *
  * @return The type of the node.
+ * @since 2.1.0
  */
 PurpleBlistNodeType purple_blist_node_get_type(PurpleBlistNode *node);
 
============================================================
--- libpurple/conversation.h	676cd2418a1d67ed678756b79655e510ba9c208d
+++ libpurple/conversation.h	4eacffd1dff6ef6444b1f36dd817e24eb743d5cf
@@ -119,7 +119,7 @@ typedef enum
 	PURPLE_MESSAGE_IMAGES      = 0x1000, /**< Message contains images  */
 	PURPLE_MESSAGE_NOTIFY      = 0x2000, /**< Message is a notification */
 	PURPLE_MESSAGE_NO_LINKIFY  = 0x4000, /**< Message should not be auto-
-										   linkified */
+										   linkified @since 2.1.0 */
 	PURPLE_MESSAGE_INVISIBLE   = 0x8000, /**< Message should not be displayed */
 } PurpleMessageFlags;
 
============================================================
--- libpurple/eventloop.h	04c332b43f75b7ca0aa07c286c61e642254ffa8b
+++ libpurple/eventloop.h	e9f1a02aeb28a9081accbbb6b9b5247d20aad2a4
@@ -141,6 +141,7 @@ struct _PurpleEventLoopUiOps
 	 * #timeout_add.
 	 *
 	 * @see purple_timeout_add_seconds()
+	 * @since 2.1.0
 	 **/
 	guint (*timeout_add_seconds)(guint interval, GSourceFunc function,
 	                             gpointer data);
============================================================
--- libpurple/prpl.h	efd045aa1c1a4a44959d513dbb3aa5dee4d5a5e2
+++ libpurple/prpl.h	b76c8732530f951383663afcb0f7b048394656bc
@@ -177,6 +177,7 @@ typedef enum
 	/**
 	 * Indicates that slash commands are native to this protocol.
 	 * Used as a hint that unknown commands should not be sent as messages.
+	 * @since 2.1.0
 	 */
 	OPT_PROTO_SLASH_COMMANDS_NATIVE = 0x00000400,
 
============================================================
--- libpurple/util.h	9a0e565f2cc2f405d95c47c3e66e2875ae081b89
+++ libpurple/util.h	286c9bda18cef3bd8a9ba3b36fc4c8a73d8cd933
@@ -1090,7 +1090,7 @@ gboolean purple_email_is_valid(const cha
 /**
  * Checks if the given IP address is a syntactically valid IPv4 address.
  *
- * @param address The IP address to validate.
+ * @param ip The IP address to validate.
  *
  * @return True if the IP address is syntactically correct.
  */
============================================================
--- pidgin/gtkthemes.h	af5b0d12647090de57148cf520133760e903e8b3
+++ pidgin/gtkthemes.h	48c0f69d65837390b32565610b25d23bd69d4427
@@ -46,10 +46,20 @@ void pidgin_themes_init(void);
 extern GSList *smiley_themes;
 
 void pidgin_themes_init(void);
+
 gboolean pidgin_themes_smileys_disabled(void);
+
 void pidgin_themes_smiley_themeize(GtkWidget *);
+
 void pidgin_themes_smiley_theme_probe(void);
+
 void pidgin_themes_load_smiley_theme(const char *file, gboolean load);
+
+/**
+ * @since 2.1.0
+ */
 void pidgin_themes_remove_smiley_theme(const char *file);
+
 GSList *pidgin_themes_get_proto_smileys(const char *id);
+
+#endif /* _PIDGINTHEMES_H_ */
-#endif /* _PIDGINDIALOGS_H_ */