1 files changed, 22 insertions, 5 deletions

diff --git a/src/fs/gnunet-fs-gtk-common.h b/src/fs/gnunet-fs-gtk-common.h
index e316768b..a24d0126 100644
--- a/src/fs/gnunet-fs-gtk-common.h
+++ b/src/fs/gnunet-fs-gtk-common.h
@@ -19,32 +19,45 @@
 */
 
 /**
- * @file src/fs/common.h
+ * @file src/fs/gnunet-fs-gtk-common.h
  * @brief Common includes for all gnunet-gtk source files
  * @author Christian Grothoff
  */
-#ifndef COMMON_H
-#define COMMON_H
+#ifndef GNUNET_FS_GTK_COMMON_H
+#define GNUNET_FS_GTK_COMMON_H
 
 #include "gnunet_gtk.h"
 #include <gnunet/gnunet_fs_service.h>
 #include <extractor.h>
 
 
-
+/**
+ * Obtain pixbuf from thumbnail data in meta data.
+ *
+ * @param meta input meta data
+ * @return NULL on error, otherwise the embedded thumbnail
+ */
 GdkPixbuf *
 GNUNET_FS_GTK_get_thumbnail_from_meta_data (const struct GNUNET_CONTAINER_MetaData *meta);
 
+
 /**
+ * FIXME: odd API...
  * Setup the expiration year adjustment to start with the
  * next year and default to next year plus one.
+ *
+ * @param builder
  */
 void
 GNUNET_FS_GTK_setup_expiration_year_adjustment (GtkBuilder *builder);
 
+
 /**
  * Convert the year from the spin button to an expiration
  * time (on midnight, January 1st of that year).
+ *
+ * @param spin button with the year
+ * @param time converted from the spin button
  */
 struct GNUNET_TIME_Absolute 
 GNUNET_FS_GTK_get_expiration_time (GtkSpinButton *spin);
@@ -53,6 +66,10 @@ GNUNET_FS_GTK_get_expiration_time (GtkSpinButton *spin);
 /**
  * mmap the given file and run the GNUNET_FS_directory_list_contents
  * function on it.
+ *
+ * @param filename name with the directory
+ * @param dep function to call on each entry
+ * @param dep_cls closure for 'dep'
  */
 void
 GNUNET_FS_GTK_mmap_and_scan (const char *filename,
@@ -86,4 +103,4 @@ GNUNET_FS_GTK_add_meta_data_to_list_store (void *cls,
                                            size_t data_len);
 
 #endif
-/* end of common.h */
+/* end of gnunet-fs-gtk-common.h */