diff src/privacy.h @ 6371:8f94cce8faa5

[gaim-migrate @ 6876] I think I touched almost every file. Here's what happened. I started off fixing up the Makefile.am and configure.ac files to help with the core/UI split some. Then I got annoyed with the build_{allow,deny}_list() functions that everything used, and decided to core/UI split privacy. While doing that, I decided to redesign the dialog. So now, a lot has changed, but not really so much. Just that most files got affected. Oh yeah, and the UI stuff was taken out of internal.h and moved to gtkinternal.h. If you use this, please be aware of this change. committer: Tailor Script <[e-mail]>

--- a/src/privacy.h	Tue Aug 05 03:21:40 2003 +0000
+++ b/src/privacy.h	Tue Aug 05 10:55:04 2003 +0000
@@ -1,7 +1,10 @@
-/*
+/**
+ * @file privacy.h Privacy API
+ * @ingroup core
+ *
  * gaim
  *
- * Copyright (C) 2003, Christian Hammond <[e-mail]>
+ * Copyright (C) 2003 Christian Hammond <[e-mail]>
  * 
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -16,19 +19,86 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
- *
  */
 #ifndef _GAIM_PRIVACY_H_
 #define _GAIM_PRIVACY_H_
 
+#include "account.h"
+
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+/**
+ * Privacy core/UI operations.
+ */
+typedef struct
+{
+	void (*permit_added)(GaimAccount *account, const char *name);
+	void (*permit_removed)(GaimAccount *account, const char *name);
+	void (*deny_added)(GaimAccount *account, const char *name);
+	void (*deny_removed)(GaimAccount *account, const char *name);
+
+} GaimPrivacyUiOps;
+
+/**
+ * Adds a user to the account's permit list.
+ *
+ * @param account The account.
+ * @Param name    The name of the user to add to the list.
+ *
+ * @return TRUE if the user was added successfully, or @c FALSE otherwise.
+ */
 gboolean gaim_privacy_permit_add(GaimAccount *account, const char *name);
+
+/**
+ * Removes a user from the account's permit list.
+ *
+ * @param account The account.
+ * @Param name    The name of the user to add to the list.
+ *
+ * @return TRUE if the user was removed successfully, or @c FALSE otherwise.
+ */
+gboolean gaim_privacy_permit_remove(GaimAccount *account, const char *name);
+
+/**
+ * Adds a user to the account's deny list.
+ *
+ * @param account The account.
+ * @Param name    The name of the user to add to the list.
+ *
+ * @return TRUE if the user was added successfully, or @c FALSE otherwise.
+ */
 gboolean gaim_privacy_deny_add(GaimAccount *account, const char *name);
+
+/**
+ * Removes a user from the account's deny list.
+ *
+ * @param account The account.
+ * @Param name    The name of the user to add to the list.
+ *
+ * @return TRUE if the user was removed successfully, or @c FALSE otherwise.
+ */
 gboolean gaim_privacy_deny_remove(GaimAccount *account, const char *name);
-gboolean gaim_privacy_permit_remove(GaimAccount *account, const char *name);
+
+/**
+ * Sets the UI operations structure for the privacy subsystem.
+ *
+ * @param ops The UI operations structure.
+ */
+void gaim_set_privacy_ui_ops(GaimPrivacyUiOps *ops);
+
+/**
+ * Returns the UI operations structure for the privacy subsystem.
+ *
+ * @return The UI operations structure.
+ */
+GaimPrivacyUiOps *gaim_get_privacy_ui_ops(void);
+
+/**
+ * Initializes the privacy subsystem.
+ */
+void gaim_privacy_init(void);
 
 #ifdef __cplusplus
 }