changeset 10566:62fc579810f4

[gaim-migrate @ 11949] Mostly some whitespace cleanups, a couple of documentation fixes/cleanups. I also removed toggle_sensitive() since it was duplicated a couple lines down. committer: Tailor Script <tailor@pidgin.im>
author Etan Reisner <pidgin@unreliablesource.net>
date Wed, 02 Feb 2005 17:13:41 +0000
parents 3b66a8f25bad
children 54f7939df8e3
files src/account.h src/blist.h src/eventloop.c src/gtksourceiter.h src/gtkutils.c src/log.h src/notify.h src/request.h
diffstat 8 files changed, 161 insertions(+), 171 deletions(-) [+]
line wrap: on
line diff
--- a/src/account.h	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/account.h	Wed Feb 02 17:13:41 2005 +0000
@@ -117,7 +117,7 @@
  *
  * @return The gaim connection.
  */
-	GaimConnection *gaim_account_connect(GaimAccount *account, GaimStatus *status);
+GaimConnection *gaim_account_connect(GaimAccount *account, GaimStatus *status);
 
 /**
  * Registers an account.
--- a/src/blist.h	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/blist.h	Wed Feb 02 17:13:41 2005 +0000
@@ -89,8 +89,9 @@
 /**************************************************************************/
 
 /**
- * A Buddy list node.  This can represent a group, a buddy, or anything else.  This is a base class for struct buddy and
- * struct group and for anything else that wants to put itself in the buddy list. */
+ * A Buddy list node.  This can represent a group, a buddy, or anything else.
+ * This is a base class for struct buddy and struct group and for anything
+ * else that wants to put itself in the buddy list. */
 struct _GaimBlistNode {
 	GaimBlistNodeType type;             /**< The type of node this is       */
 	GaimBlistNode *prev;                /**< The sibling before this buddy. */
@@ -517,7 +518,6 @@
  * gaim_contact_get_priority_buddy recomputes it.
  *
  * @param contact  The contact
- * @return The highest priority buddy
  */
 void gaim_contact_invalidate_priority_buddy(GaimContact *contact);
 /**
--- a/src/eventloop.c	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/eventloop.c	Wed Feb 02 17:13:41 2005 +0000
@@ -71,5 +71,3 @@
 
 	return eventloop_ui_ops;
 }
-
-
--- a/src/gtksourceiter.h	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/gtksourceiter.h	Wed Feb 02 17:13:41 2005 +0000
@@ -34,21 +34,21 @@
 	/* Possible future plans: SEARCH_REGEXP */
 } GtkSourceSearchFlags;
 
-gboolean gtk_source_iter_forward_search 	(const GtkTextIter   *iter,
+gboolean gtk_source_iter_forward_search	(const GtkTextIter   *iter,
 						 const gchar         *str,
 						 GtkSourceSearchFlags flags,
 						 GtkTextIter         *match_start,
 						 GtkTextIter         *match_end,
 						 const GtkTextIter   *limit);
 
-gboolean gtk_source_iter_backward_search 	(const GtkTextIter   *iter,
+gboolean gtk_source_iter_backward_search	(const GtkTextIter   *iter,
 						 const gchar         *str,
 						 GtkSourceSearchFlags flags,
 						 GtkTextIter         *match_start,
 						 GtkTextIter         *match_end,
 						 const GtkTextIter   *limit);
 
-gboolean gtk_source_iter_find_matching_bracket 	(GtkTextIter         *iter);
+gboolean gtk_source_iter_find_matching_bracket	(GtkTextIter         *iter);
 
 G_END_DECLS
 
--- a/src/gtkutils.c	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/gtkutils.c	Wed Feb 02 17:13:41 2005 +0000
@@ -167,14 +167,6 @@
 }
 
 void
-toggle_sensitive(GtkWidget *widget, GtkWidget *to_toggle)
-{
-	gboolean sensitivity = GTK_WIDGET_IS_SENSITIVE(to_toggle);
-
-	gtk_widget_set_sensitive(to_toggle, !sensitivity);
-}
-
-void
 gaim_gtk_set_sensitive_if_input(GtkWidget *entry, GtkWidget *dialog)
 {
 	const char *text = gtk_entry_get_text(GTK_ENTRY(entry));
--- a/src/log.h	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/log.h	Wed Feb 02 17:13:41 2005 +0000
@@ -112,175 +112,175 @@
 extern "C" {
 #endif
 
-	/***************************************/
-	/** @name Log Functions                */
-	/***************************************/
-	/*@{*/
+/***************************************/
+/** @name Log Functions                */
+/***************************************/
+/*@{*/
 
-	/**
-	 * Creates a new log
-	 *
-	 * @param type        The type of log this is.
-	 * @param name        The name of this conversation (Screenname, chat name,
-	 *                    etc.)
-	 * @param account     The account the conversation is occurring on
-	 * @param time        The time this conversation started
-	 * @return            The new log
-	 */
-	GaimLog *gaim_log_new(GaimLogType type, const char *name,
-			GaimAccount *account, time_t time);
+/**
+ * Creates a new log
+ *
+ * @param type        The type of log this is.
+ * @param name        The name of this conversation (Screenname, chat name,
+ *                    etc.)
+ * @param account     The account the conversation is occurring on
+ * @param time        The time this conversation started
+ * @return            The new log
+ */
+GaimLog *gaim_log_new(GaimLogType type, const char *name,
+		GaimAccount *account, time_t time);
 
-	/**
-	 * Frees a log
-	 *
-	 * @param log         The log to destroy
-	 */
-	void gaim_log_free(GaimLog *log);
+/**
+ * Frees a log
+ *
+ * @param log         The log to destroy
+ */
+void gaim_log_free(GaimLog *log);
 
-	/**
-	 * Writes to a log file. Assumes you have checked preferences already.
-	 *
-	 * @param log          The log to write to
-	 * @param type         The type of message being logged
-	 * @param from         Whom this message is coming from, or NULL for
-	 *                     system messages
-	 * @param time         A timestamp in UNIX time
-	 * @param message      The message to log
-	 */
-	void gaim_log_write(GaimLog *log,
-			    GaimMessageFlags type,
-			    const char *from,
-			    time_t time,
-			    const char *message);
+/**
+ * Writes to a log file. Assumes you have checked preferences already.
+ *
+ * @param log          The log to write to
+ * @param type         The type of message being logged
+ * @param from         Whom this message is coming from, or NULL for
+ *                     system messages
+ * @param time         A timestamp in UNIX time
+ * @param message      The message to log
+ */
+void gaim_log_write(GaimLog *log,
+		    GaimMessageFlags type,
+		    const char *from,
+		    time_t time,
+		    const char *message);
 
-	/**
-	 * Reads from a log
-	 *
-	 * @param log   The log to read from
-	 * @param flags The returned logging flags.
-	 *
-	 * @return The contents of this log in Gaim Markup.
-	 */
-	char *gaim_log_read(GaimLog *log, GaimLogReadFlags *flags);
+/**
+ * Reads from a log
+ *
+ * @param log   The log to read from
+ * @param flags The returned logging flags.
+ *
+ * @return The contents of this log in Gaim Markup.
+ */
+char *gaim_log_read(GaimLog *log, GaimLogReadFlags *flags);
 
-	/**
-	 * Returns a list of all available logs
-	 *
-	 * @param type                The type of the log
-	 * @param name                The name of the log
-	 * @param account             The account
-	 * @return                    A sorted list of GaimLogs
-	 */
-	GList *gaim_log_get_logs(GaimLogType type, const char *name, GaimAccount *account);
+/**
+ * Returns a list of all available logs
+ *
+ * @param type                The type of the log
+ * @param name                The name of the log
+ * @param account             The account
+ * @return                    A sorted list of GaimLogs
+ */
+GList *gaim_log_get_logs(GaimLogType type, const char *name, GaimAccount *account);
 
-	/**
-	 * Returns a list of all available system logs
-	 *
-	 * @param account The account
-	 * @return		A sorted list of GaimLogs
-	 */
-	GList *gaim_log_get_system_logs(GaimAccount *account);
+/**
+ * Returns a list of all available system logs
+ *
+ * @param account The account
+ * @return		A sorted list of GaimLogs
+ */
+GList *gaim_log_get_system_logs(GaimAccount *account);
 
-	/**
-	 * Returns the size of a log 
-	 *
-	 * @param log                 The log
-	 * @return                    The size of the log, in bytes
-	 */
-	int gaim_log_get_size(GaimLog *log);
+/**
+ * Returns the size of a log 
+ *
+ * @param log                 The log
+ * @return                    The size of the log, in bytes
+ */
+int gaim_log_get_size(GaimLog *log);
 
-	/**
-	 * Returns the size, in bytes, of all available logs in this conversation
-	 *
-	 * @param type                The type of the log
-	 * @param name                The name of the log
-	 * @param account             The account
-	 * @return                    The size in bytes
-	 */
-	 int gaim_log_get_total_size(GaimLogType type, const char *name, GaimAccount *account);
+/**
+ * Returns the size, in bytes, of all available logs in this conversation
+ *
+ * @param type                The type of the log
+ * @param name                The name of the log
+ * @param account             The account
+ * @return                    The size in bytes
+ */
+int gaim_log_get_total_size(GaimLogType type, const char *name, GaimAccount *account);
 
-	/**
-	 * Implements GCompareFunc
-	 *
-	 * @param y				   A GaimLog
-	 * @param z				   Another GaimLog
-	 * @return					A value as specified by GCompareFunc
-	 */
-	 gint gaim_log_compare(gconstpointer y, gconstpointer z);
-	/*@}*/
+/**
+ * Implements GCompareFunc
+ *
+ * @param y				   A GaimLog
+ * @param z				   Another GaimLog
+ * @return					A value as specified by GCompareFunc
+ */
+gint gaim_log_compare(gconstpointer y, gconstpointer z);
+/*@}*/
 
-	/******************************************/
-	/** @name Logger Functions                */
-	/******************************************/
-	/*@{*/
+/******************************************/
+/** @name Logger Functions                */
+/******************************************/
+/*@{*/
 
-	/**
-	 * Creates a new logger
-	 *
-	 * @param create   The logger's new function.
-	 * @param write    The logger's write function.
-	 * @param finalize The logger's finalize function.
-	 * @param list     The logger's list function.
-	 * @param read     The logger's read function.
-	 * @param size     The logger's size function.
-	 *
-	 * @return The new logger
-	 */
-	GaimLogLogger *gaim_log_logger_new(
-					void(*create)(GaimLog *),
-					void(*write)(GaimLog *, GaimMessageFlags, const char *, time_t, const char *),
-					void(*finalize)(GaimLog *),
-					GList*(*list)(GaimLogType type, const char*, GaimAccount*),
-					char*(*read)(GaimLog*, GaimLogReadFlags*),
-					int(*size)(GaimLog*));
-	/**
-	 * Frees a logger
-	 *
-	 * @param logger       The logger to free
-	 */
-	void gaim_log_logger_free(GaimLogLogger *logger);
+/**
+ * Creates a new logger
+ *
+ * @param create   The logger's new function.
+ * @param write    The logger's write function.
+ * @param finalize The logger's finalize function.
+ * @param list     The logger's list function.
+ * @param read     The logger's read function.
+ * @param size     The logger's size function.
+ *
+ * @return The new logger
+ */
+GaimLogLogger *gaim_log_logger_new(
+				void(*create)(GaimLog *),
+				void(*write)(GaimLog *, GaimMessageFlags, const char *, time_t, const char *),
+				void(*finalize)(GaimLog *),
+				GList*(*list)(GaimLogType type, const char*, GaimAccount*),
+				char*(*read)(GaimLog*, GaimLogReadFlags*),
+				int(*size)(GaimLog*));
+/**
+ * Frees a logger
+ *
+ * @param logger       The logger to free
+ */
+void gaim_log_logger_free(GaimLogLogger *logger);
 
-	/**
-	 * Adds a new logger
-	 *
-	 * @param logger       The new logger to add
-	 */
-	void gaim_log_logger_add (GaimLogLogger *logger);
+/**
+ * Adds a new logger
+ *
+ * @param logger       The new logger to add
+ */
+void gaim_log_logger_add (GaimLogLogger *logger);
 
-	/**
-	 *
-	 * Removes a logger
-	 *
-	 * @param logger       The logger to remove
-	 */
-	void gaim_log_logger_remove (GaimLogLogger *logger);
+/**
+ *
+ * Removes a logger
+ *
+ * @param logger       The logger to remove
+ */
+void gaim_log_logger_remove (GaimLogLogger *logger);
 
-	/**
-	 *
-	 * Sets the current logger
-	 *
-	 * @param logger       The logger to set
-	 */
-	void gaim_log_logger_set (GaimLogLogger *logger);
+/**
+ *
+ * Sets the current logger
+ *
+ * @param logger       The logger to set
+ */
+void gaim_log_logger_set (GaimLogLogger *logger);
 
-	/**
-	 *
-	 * Returns the current logger
-	 *
-	 * @return logger      The current logger
-	 */
-	GaimLogLogger *gaim_log_logger_get (void);
+/**
+ *
+ * Returns the current logger
+ *
+ * @return logger      The current logger
+ */
+GaimLogLogger *gaim_log_logger_get (void);
 
-	/**
-	 * Returns a GList containing the IDs and Names of the registered log
-	 * loggers.
-	 *
-	 * @return The list of IDs and names.
-	 */
-	GList *gaim_log_logger_get_options(void);
+/**
+ * Returns a GList containing the IDs and Names of the registered log
+ * loggers.
+ *
+ * @return The list of IDs and names.
+ */
+GList *gaim_log_logger_get_options(void);
 
-	void gaim_log_init(void);
-	/*@}*/
+void gaim_log_init(void);
+/*@}*/
 
 
 #ifdef __cplusplus
--- a/src/notify.h	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/notify.h	Wed Feb 02 17:13:41 2005 +0000
@@ -280,7 +280,7 @@
 /*@}*/
 
 /**************************************************************************/
-/** @name UI Operations API                                               */
+/** @name UI Registration Functions                                       */
 /**************************************************************************/
 /*@{*/
 
--- a/src/request.h	Wed Feb 02 00:07:18 2005 +0000
+++ b/src/request.h	Wed Feb 02 17:13:41 2005 +0000
@@ -1276,7 +1276,7 @@
 /*@}*/
 
 /**************************************************************************/
-/** @name UI Operations API                                               */
+/** @name UI Registration Functions                                       */
 /**************************************************************************/
 /*@{*/