[GNUnet-SVN] r33594 - in gnunet-gtk/src: conversation fs include

[gnunet]

Author: grothoff
Date: 2014-06-08 00:15:54 +0200 (Sun, 08 Jun 2014)
New Revision: 33594

Modified:
   gnunet-gtk/src/conversation/gnunet-conversation-gtk_contacts.c
   gnunet-gtk/src/conversation/gnunet-conversation-gtk_get_label.c
   gnunet-gtk/src/conversation/gnunet-conversation-gtk_log.h
   gnunet-gtk/src/conversation/gnunet-conversation-gtk_phone.c
   gnunet-gtk/src/fs/gnunet-fs-gtk_event-handler.c
   gnunet-gtk/src/include/gnunet_gtk.h
Log:
-more doxygen fixes, indentation

Modified: gnunet-gtk/src/conversation/gnunet-conversation-gtk_contacts.c
===================================================================
--- gnunet-gtk/src/conversation/gnunet-conversation-gtk_contacts.c      
2014-06-07 22:09:28 UTC (rev 33593)
+++ gnunet-gtk/src/conversation/gnunet-conversation-gtk_contacts.c      
2014-06-07 22:15:54 UTC (rev 33594)
@@ -131,9 +131,9 @@
  * adding/modifying/removing it in the liststore.
  *
  * @param cls closure
- * @param zone private key of the zone; NULL on disconnect
- * @param label label of the records; NULL on disconnect
- * @param rd_count number of entries in @a rd array, 0 if label was deleted
+ * @param zone_key private key of the zone; NULL on disconnect
+ * @param rname label of the records; NULL on disconnect
+ * @param rd_len number of entries in @a rd array, 0 if label was deleted
  * @param rd array of records with data to store
  */
 static void
@@ -290,7 +290,7 @@
  *
  * @param clipboard the clipboard
  * @param text the text from the board
- * @param user_data NULL
+ * @param data NULL
  */
 static void
 handle_paste_data (GtkClipboard *clipboard,

Modified: gnunet-gtk/src/conversation/gnunet-conversation-gtk_get_label.c
===================================================================
--- gnunet-gtk/src/conversation/gnunet-conversation-gtk_get_label.c     
2014-06-07 22:09:28 UTC (rev 33593)
+++ gnunet-gtk/src/conversation/gnunet-conversation-gtk_get_label.c     
2014-06-07 22:15:54 UTC (rev 33594)
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file src/conversation/gnunet-conversation-gtk_use_current.c
+ * @file src/conversation/gnunet-conversation-gtk_get_label.c
  * @brief logic to import caller ID into address book
  * @author Christian Grothoff
  */

Modified: gnunet-gtk/src/conversation/gnunet-conversation-gtk_log.h
===================================================================
--- gnunet-gtk/src/conversation/gnunet-conversation-gtk_log.h   2014-06-07 
22:09:28 UTC (rev 33593)
+++ gnunet-gtk/src/conversation/gnunet-conversation-gtk_log.h   2014-06-07 
22:15:54 UTC (rev 33594)
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file src/identity/gnunet-identity-gtk_log.h
+ * @file src/conversation/gnunet-conversation-gtk_log.h
  * @author Christian Grothoff
  */
 #ifndef GNUNET_CONVERSATION_GTK_LOG_H

Modified: gnunet-gtk/src/conversation/gnunet-conversation-gtk_phone.c
===================================================================
--- gnunet-gtk/src/conversation/gnunet-conversation-gtk_phone.c 2014-06-07 
22:09:28 UTC (rev 33593)
+++ gnunet-gtk/src/conversation/gnunet-conversation-gtk_phone.c 2014-06-07 
22:15:54 UTC (rev 33594)
@@ -459,8 +459,6 @@
 
 /**
  * Update status based on current phone state.
- *
- * @param args arguments given to the command
  */
 static void
 do_status ()

Modified: gnunet-gtk/src/fs/gnunet-fs-gtk_event-handler.c
===================================================================
--- gnunet-gtk/src/fs/gnunet-fs-gtk_event-handler.c     2014-06-07 22:09:28 UTC 
(rev 33593)
+++ gnunet-gtk/src/fs/gnunet-fs-gtk_event-handler.c     2014-06-07 22:15:54 UTC 
(rev 33594)
@@ -756,7 +756,7 @@
  * Obtain the iterator for the respective download entry.
  *
  * @param de the download entry
- * @param[OUT] iter set to the respective position in the #downloads_treestore
+ * @param[out] iter set to the respective position in the #downloads_treestore
  */
 static void
 get_download_list_entry (struct DownloadEntry *de,

Modified: gnunet-gtk/src/include/gnunet_gtk.h
===================================================================
--- gnunet-gtk/src/include/gnunet_gtk.h 2014-06-07 22:09:28 UTC (rev 33593)
+++ gnunet-gtk/src/include/gnunet_gtk.h 2014-06-07 22:15:54 UTC (rev 33594)
@@ -64,7 +64,8 @@
  * @return new main window to initialize
  */
 GtkWidget *
-GNUNET_GTK_plug_me (const char *env_name, GtkWidget * main_window);
+GNUNET_GTK_plug_me (const char *env_name,
+                    GtkWidget *main_window);
 
 
 /**
@@ -116,7 +117,8 @@
  * @return NULL on error
  */
 GtkBuilder *
-GNUNET_GTK_get_new_builder2 (const char *filename, void *user_data,
+GNUNET_GTK_get_new_builder2 (const char *filename,
+                             void *user_data,
                              GtkBuilderConnectFunc cb);
 
 
@@ -154,8 +156,10 @@
  * @return TRUE on success, FALSE on errors
  */
 gboolean
-GNUNET_GTK_get_tree_string (GtkTreeView * treeview, GtkTreePath * treepath,
-                            guint column, gchar ** value);
+GNUNET_GTK_get_tree_string (GtkTreeView *treeview,
+                            GtkTreePath *treepath,
+                            guint column,
+                            gchar **value);
 
 
 /**
@@ -175,13 +179,12 @@
 /**
  * Change our tray icon.
  *
- * @param ml main loop
- * @param main handle to the main window (show or hide)
  * @param icon_name name of the tray icon file
  * @param tooltip tooltip for the tray icon
  */
 void
-GNUNET_GTK_tray_icon_change (const char *icon_name, const char *tooltip);
+GNUNET_GTK_tray_icon_change (const char *icon_name,
+                             const char *tooltip);
 
 
 /**
@@ -208,7 +211,7 @@
  * @return selected filename as UTF-8, NULL on errors
  */
 char *
-GNUNET_GTK_filechooser_get_filename_utf8 (GtkFileChooser * fc);
+GNUNET_GTK_filechooser_get_filename_utf8 (GtkFileChooser *fc);
 
 
 /**
@@ -218,7 +221,8 @@
  * @param root root of the subtree to remove
  */
 void
-GNUNET_FS_GTK_remove_treestore_subtree (GtkTreeStore * ts, GtkTreeIter * root);
+GNUNET_FS_GTK_remove_treestore_subtree (GtkTreeStore *ts,
+                                        GtkTreeIter *root);
 
 
 /* ******************* main loop ***************** */
@@ -233,11 +237,12 @@
  * @param argv command line options
  * @param options allowed command line options
  * @param main_window_file glade file for the main window
- * @param main_task first task to run, closure will be set to the 'struct 
GNUNET_GTK_MainLoop'
+ * @param main_task first task to run, closure will be set to the `struct 
GNUNET_GTK_MainLoop`
  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error (i.e. bad 
command-line options, etc)
  */
 int
-GNUNET_GTK_main_loop_start (const char *binary_name, const char *binary_help,
+GNUNET_GTK_main_loop_start (const char *binary_name,
+                            const char *binary_help,
                             int argc, char *const *argv,
                             struct GNUNET_GETOPT_CommandLineOption *options,
                             const char *main_window_file,
@@ -255,6 +260,7 @@
 GNUNET_GTK_main_loop_get_object (struct GNUNET_GTK_MainLoop *ml,
                                  const char *name);
 
+
 /**
  * Get the builder from the main window.
  *
@@ -265,7 +271,6 @@
 GNUNET_GTK_main_loop_get_builder (struct GNUNET_GTK_MainLoop *ml);
 
 
-
 /**
  * Get remaining command line arguments.
  *
@@ -274,7 +279,8 @@
  * @param argv set to argument vector
  */
 void
-GNUNET_GTK_main_loop_get_args (struct GNUNET_GTK_MainLoop *ml, int *argc,
+GNUNET_GTK_main_loop_get_args (struct GNUNET_GTK_MainLoop *ml,
+                               int *argc,
                                char *const **argv);
 
 
@@ -383,8 +389,8 @@
  * @return handle to unregister the tree view later
  */
 struct GNUNET_FS_AnimationTreeViewHandle *
-GNUNET_GTK_animation_tree_view_register (GtkTreeView * tv,
-                                         GtkTreeViewColumn * image_col);
+GNUNET_GTK_animation_tree_view_register (GtkTreeView *tv,
+                                         GtkTreeViewColumn *image_col);
 
 
 /**
@@ -393,9 +399,7 @@
  * @param atv tree view to unregister
  */
 void
-GNUNET_GTK_animation_tree_view_unregister (struct
-                                           GNUNET_FS_AnimationTreeViewHandle
-                                           *atv);
+GNUNET_GTK_animation_tree_view_unregister (struct 
GNUNET_FS_AnimationTreeViewHandle *atv);
 
 
 /* ********************* generic helpers ******************* */
@@ -406,19 +410,19 @@
  */
 enum GNUNET_GTK_FS_MAIN_WINDOW_AnonymityLevelModelColumns
 {
-    /**
-     * A gchararray.
-     */
+  /**
+   * A gchararray.
+   */
   GNUNET_GTK_ANONYMITY_LEVEL_MC_NAME = 0,
 
-    /**
-     * A guint.
-     */
+  /**
+   * A guint.
+   */
   GNUNET_GTK_ANONYMITY_LEVEL_MC_LEVEL = 1,
 
-    /**
-     * A gchararray.
-     */
+  /**
+   * A gchararray.
+   */
   GNUNET_GTK_ANONYMITY_LEVEL_MC_COLOR = 2
 };
 
@@ -431,7 +435,7 @@
  * @return time converted from the spin button
  */
 struct GNUNET_TIME_Absolute
-GNUNET_GTK_get_expiration_time (GtkSpinButton * spin);
+GNUNET_GTK_get_expiration_time (GtkSpinButton *spin);
 
 
 /**
@@ -444,7 +448,7 @@
  * the adjustment
  */
 void
-GNUNET_GTK_setup_expiration_year_adjustment (GtkBuilder * builder);
+GNUNET_GTK_setup_expiration_year_adjustment (GtkBuilder *builder);
 
 
 /**
@@ -456,8 +460,9 @@
  * @return TRUE on success, FALSE on failure
  */
 gboolean
-GNUNET_GTK_get_selected_anonymity_level (GtkBuilder * builder,
-                                         gchar * combo_name, guint * p_level);
+GNUNET_GTK_get_selected_anonymity_level (GtkBuilder *builder,
+                                         gchar *combo_name,
+                                         guint *p_level);
 
 
 /**
@@ -468,8 +473,8 @@
  * @return TRUE on success, FALSE on failure
  */
 gboolean
-GNUNET_GTK_get_selected_anonymity_combo_level (GtkComboBox * combo,
-                                               guint * p_level);
+GNUNET_GTK_get_selected_anonymity_combo_level (GtkComboBox *combo,
+                                               guint *p_level);
 
 
 #endif