1 files changed, 10 insertions, 5 deletions

diff --git a/src/include/gnunet_gtk.h b/src/include/gnunet_gtk.h
index 88d03481..5f38dd3c 100644
--- a/src/include/gnunet_gtk.h
+++ b/src/include/gnunet_gtk.h
@@ -1,6 +1,6 @@
 /*
      This file is part of GNUnet.
-     (C) 2011 Christian Grothoff (and other contributing authors)
+     (C) 2011, 2013 Christian Grothoff (and other contributing authors)
 
      GNUnet is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published
@@ -82,8 +82,10 @@ GNUNET_GTK_get_data_dir (void);
 
 /**
  * @brief get the path to a specific GNUnet installation directory or,
- * with GNUNET_IPK_SELF_PREFIX, the current running apps installation directory
+ * with #GNUNET_OS_IPK_SELF_PREFIX, the current running apps installation directory
  * @author Milan
+ *
+ * @param dirkind which directory should be returned
  * @return a pointer to the dir path (to be freed by the caller)
  */
 char *
@@ -107,7 +109,10 @@ GNUNET_GTK_get_new_builder (const char *filename,
 
 
 /**
- * This displays an about dialog.
+ * This displays an about dialog.  The dialog must be called
+ * "about_window" with "about_credits_notebook" and
+ * "about_license_scroller" and "about_license_contents" being the
+ * respective subdialogs.
  *
  * @param dialogfile name of the glade file containing the dialog
  */
@@ -195,7 +200,7 @@ GNUNET_FS_GTK_remove_treestore_subtree (GtkTreeStore * ts,
  * @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'
- * @return GNUNET_OK on success, GNUNET_SYSERR on error (i.e. bad command-line options, etc)
+ * @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,
@@ -308,7 +313,7 @@ GNUNET_GTK_animation_context_destroy (struct GNUNET_FS_AnimationContext *ac);
  * Obtain the animated pixbuf from an animation context.  Note
  * that the pixbuf will only properly work within GtkTreeViews
  * where the column with the image has been registered using
- * GNUNET_GTK_animation_tree_view_register.
+ * #GNUNET_GTK_animation_tree_view_register.
  *
  * @param ac animation context to query
  * @return pixbuf of the AC, NULL on error loading the pixbuf