-doxygen fixes

11 files changed, 59 insertions, 75 deletions

diff --git a/src/fs/gnunet-fs-gtk_event-handler.c b/src/fs/gnunet-fs-gtk_event-handler.c
index a441eeaf..de01865e 100644
--- a/src/fs/gnunet-fs-gtk_event-handler.c
+++ b/src/fs/gnunet-fs-gtk_event-handler.c
@@ -909,7 +909,7 @@ download_as_ctx_menu (GtkMenuItem *item, gpointer user_data)
  * Download "abort" was selected in the current search context menu.
  * 
  * @param item the 'abort' menu item
- * @parma user_data the 'struct SearchListPopupContext' with the download to abort.
+ * @param user_data the 'struct SearchListPopupContext' with the download to abort.
  */
 static void
 abort_download_ctx_menu (GtkMenuItem *item, gpointer user_data)
@@ -929,7 +929,7 @@ abort_download_ctx_menu (GtkMenuItem *item, gpointer user_data)
  * Copy current URI to clipboard was selected in the current context menu.
  * 
  * @param item the 'copy-to-clipboard' menu item
- * @parma user_data the 'struct SearchListPopupContext' of the menu
+ * @param user_data the 'struct SearchListPopupContext' of the menu
  */
 static void
 copy_search_uri_to_clipboard_ctx_menu (GtkMenuItem *item, gpointer user_data)
@@ -2357,8 +2357,8 @@ GNUNET_GTK_add_search_result (struct SearchTab *tab,
 
 
 /**
- * Sets downloaded name on an item referenced by @rr
- * in a tree store @ts to @filename.
+ * Sets downloaded name on an item referenced by @a rr
+ * in a tree store @a ts to @a filename.
  * Used by SaveAs dialog to communicate back new filename
  * (unless SaveAs dialog initiates the download by itself).
  * Arguments can be taken from DownloadEntry.
@@ -3535,7 +3535,7 @@ publish_list_popup_selection_done (GtkMenuShell *menushell,
  * Publish "abort" was selected in the current publish context menu.
  * 
  * @param item the 'abort' menu item
- * @parma user_data the 'struct PublishListPopupContext' with the operation to abort.
+ * @param user_data the 'struct PublishListPopupContext' with the operation to abort.
  */
 static void
 abort_publish_ctx_menu (GtkMenuItem *item, gpointer user_data)
@@ -3552,7 +3552,7 @@ abort_publish_ctx_menu (GtkMenuItem *item, gpointer user_data)
  * Copy current URI to clipboard was selected in the current context menu.
  * 
  * @param item the 'copy-to-clipboard' menu item
- * @parma user_data the 'struct DownloadListPopupContext' of the menu
+ * @param user_data the 'struct DownloadListPopupContext' of the menu
  */
 static void
 copy_publish_uri_to_clipboard_ctx_menu (GtkMenuItem *item, gpointer user_data)
diff --git a/src/fs/gnunet-fs-gtk_publish-edit-dialog.c b/src/fs/gnunet-fs-gtk_publish-edit-dialog.c
index 46ac1f63..22d6e6ed 100644
--- a/src/fs/gnunet-fs-gtk_publish-edit-dialog.c
+++ b/src/fs/gnunet-fs-gtk_publish-edit-dialog.c
@@ -419,7 +419,7 @@ GNUNET_GTK_edit_publication_metadata_tree_view_type_renderer_edited_cb (GtkCellR
  * 'GNUNET_GTK_edit_publication_metadata_tree_view_type_renderer_edited_cb'.
  *
  * @param combo combo box that was dropped down
- * @param path which item was changed in the tree view
+ * @param path_string which item was changed in the tree view
  * @param new_iter item that is now selected in the drop-down combo box
  * @param user_data the 'struct EditPublicationDialogContext' 
  */
diff --git a/src/fs/gnunet-fs-gtk_unindex.c b/src/fs/gnunet-fs-gtk_unindex.c
index 442487af..83236142 100644
--- a/src/fs/gnunet-fs-gtk_unindex.c
+++ b/src/fs/gnunet-fs-gtk_unindex.c
@@ -430,11 +430,12 @@ GNUNET_GTK_main_menu_unindex_activate_cb (GtkWidget * dummy,
  * An unindex operation resumed.  Setup the
  * internal context for Gtk.
  *
- * @param fs unindex context with the FS library
+ * @param uc unindex context with the FS library
  * @param filename name of file being unindexed
  * @param filesize size of the file
  * @param completed how many bytes were done so far
  * @param emsg NULL if everything is fine, otherwise error message
+ * @return entry for the resumed operation
  */
 struct UnindexEntry *
 GNUNET_FS_GTK_unindex_handle_resume_ (struct GNUNET_FS_UnindexContext *uc,
@@ -460,7 +461,7 @@ GNUNET_FS_GTK_unindex_handle_resume_ (struct GNUNET_FS_UnindexContext *uc,
 
 
 /**
- * FS notified us that our undex operation was stopped.
+ * FS notified us that our unindex operation was stopped.
  *
  * @param ue operation that stopped
  */
@@ -496,7 +497,7 @@ GNUNET_FS_GTK_unindex_handle_stop_ (struct UnindexEntry *ue)
 
 
 /**
- * FS notified us that our undex operation had an error.
+ * FS notified us that our unindex operation had an error.
  *
  * @param ue operation that had an error
  * @param emsg error message
@@ -527,7 +528,7 @@ GNUNET_FS_GTK_unindex_handle_error_ (struct UnindexEntry *ue,
 
 
 /**
- * FS notified us that our undex operation made progress
+ * FS notified us that our unindex operation made progress
  *
  * @param ue operation that made progress
  * @param completed number of bytes completed now
@@ -557,7 +558,7 @@ GNUNET_FS_GTK_unindex_handle_progress_ (struct UnindexEntry *ue,
 
 
 /**
- * FS notified us that our undex operation completed
+ * FS notified us that our unindex operation completed
  *
  * @param ue operation that completed
  */
diff --git a/src/fs/gnunet-fs-gtk_unindex.h b/src/fs/gnunet-fs-gtk_unindex.h
index d1f79006..8a73241d 100644
--- a/src/fs/gnunet-fs-gtk_unindex.h
+++ b/src/fs/gnunet-fs-gtk_unindex.h
@@ -40,11 +40,12 @@ struct UnindexEntry;
  * An unindex operation resumed.  Setup the
  * internal context for Gtk.
  *
- * @param fs unindex context with the FS library
+ * @param uc unindex context with the FS library
  * @param filename name of file being unindexed
  * @param filesize size of the file
  * @param completed how many bytes were done so far
  * @param emsg NULL if everything is fine, otherwise error message
+ * @return entry for the resumed operation
  */
 struct UnindexEntry *
 GNUNET_FS_GTK_unindex_handle_resume_ (struct GNUNET_FS_UnindexContext *uc,
@@ -55,7 +56,7 @@ GNUNET_FS_GTK_unindex_handle_resume_ (struct GNUNET_FS_UnindexContext *uc,
 
 
 /**
- * FS notified us that our undex operation was stopped.
+ * FS notified us that our unindex operation was stopped.
  *
  * @param ue operation that stopped
  */
@@ -64,7 +65,7 @@ GNUNET_FS_GTK_unindex_handle_stop_ (struct UnindexEntry *ue);
 
 
 /**
- * FS notified us that our undex operation had an error.
+ * FS notified us that our unindex operation had an error.
  *
  * @param ue operation that
  * @param emsg error message
@@ -75,7 +76,7 @@ GNUNET_FS_GTK_unindex_handle_error_ (struct UnindexEntry *ue,
 
 
 /**
- * FS notified us that our undex operation made progress
+ * FS notified us that our unindex operation made progress
  *
  * @param ue operation that made progress
  * @param completed number of bytes completed now
@@ -86,7 +87,7 @@ GNUNET_FS_GTK_unindex_handle_progress_ (struct UnindexEntry *ue,
 
 
 /**
- * FS notified us that our undex operation completed
+ * FS notified us that our unindex operation completed
  *
  * @param ue operation that completed
  */
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
diff --git a/src/lib/about.c b/src/lib/about.c
index 58c6aafc..ec63a091 100644
--- a/src/lib/about.c
+++ b/src/lib/about.c
@@ -117,10 +117,12 @@ GNUNET_GTK_about_license_button_clicked (GtkButton * widget, struct AboutDialogC
 
 
 /**
- * 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
- * @param dialogname name of the about dialog in the file
  */
 void
 GNUNET_GTK_display_about (const char *dialogfile)
diff --git a/src/lib/os_installation.c b/src/lib/os_installation.c
index db2c3360..e73ed63e 100644
--- a/src/lib/os_installation.c
+++ b/src/lib/os_installation.c
@@ -304,7 +304,6 @@ get_path_from_dyld_image ()
  * Return the actual path to a file found in the current
  * PATH environment variable.
  *
- * @param binary the name of the file to find
  * @return path to binary, NULL if not found
  */
 static char *
diff --git a/src/setup/gnunet-setup-gns-edit.c b/src/setup/gnunet-setup-gns-edit.c
index 9759ecdf..8bb79b21 100644
--- a/src/setup/gnunet-setup-gns-edit.c
+++ b/src/setup/gnunet-setup-gns-edit.c
@@ -465,6 +465,7 @@ edit_dialog_a_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -497,7 +498,6 @@ GNS_edit_a_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -513,7 +513,6 @@ GNS_edit_dialog_a_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'A' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -575,6 +574,7 @@ edit_dialog_aaaa_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -607,7 +607,6 @@ GNS_edit_aaaa_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -623,7 +622,6 @@ GNS_edit_dialog_aaaa_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'AAAA' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -684,6 +682,7 @@ edit_dialog_cname_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -716,7 +715,6 @@ GNS_edit_cname_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -732,7 +730,6 @@ GNS_edit_dialog_cname_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'CNAME' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -793,6 +790,7 @@ edit_dialog_leho_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -825,7 +823,6 @@ GNS_edit_leho_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -841,7 +838,6 @@ GNS_edit_dialog_leho_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'LEHO' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -902,6 +898,7 @@ edit_dialog_mx_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -943,7 +940,6 @@ GNS_edit_mx_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -959,7 +955,6 @@ GNS_edit_dialog_mx_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'MX' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -1036,12 +1031,13 @@ edit_dialog_ns_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
 GNS_edit_ns_dialog_response_cb (GtkDialog *dialog,
-                                   gint response_id,
-                                   gpointer user_data)
+                                gint response_id,
+                                gpointer user_data)
 {
   struct EditDialogContext *edc = user_data;
   GtkEntry *entry;
@@ -1068,12 +1064,11 @@ GNS_edit_ns_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
 GNS_edit_dialog_ns_entry_changed_cb (GtkEditable *entry,
-                                       gpointer user_data)
+                                     gpointer user_data)
 {
   struct EditDialogContext *edc = user_data;
 
@@ -1084,7 +1079,6 @@ GNS_edit_dialog_ns_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'NS' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -1149,6 +1143,7 @@ edit_dialog_pkey_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -1181,7 +1176,6 @@ GNS_edit_pkey_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -1197,7 +1191,6 @@ GNS_edit_dialog_pkey_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'PKEY' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -1258,12 +1251,13 @@ edit_dialog_ptr_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
 GNS_edit_ptr_dialog_response_cb (GtkDialog *dialog,
-                                   gint response_id,
-                                   gpointer user_data)
+                                 gint response_id,
+                                 gpointer user_data)
 {
   struct EditDialogContext *edc = user_data;
   GtkEntry *entry;
@@ -1290,7 +1284,6 @@ GNS_edit_ptr_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -1306,7 +1299,6 @@ GNS_edit_dialog_ptr_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'PTR' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -1382,6 +1374,7 @@ edit_dialog_soa_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -1442,7 +1435,6 @@ GNS_edit_soa_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -1460,7 +1452,6 @@ GNS_edit_dialog_soa_contact_email_entry_changed_cb (GtkEditable *entry,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -1476,7 +1467,6 @@ GNS_edit_dialog_soa_source_host_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'SOA' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -1583,6 +1573,7 @@ edit_dialog_srv_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
@@ -1620,7 +1611,6 @@ GNS_edit_srv_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -1636,7 +1626,6 @@ GNS_edit_dialog_srv_target_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'SRV' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -1688,12 +1677,13 @@ edit_dialog_txt_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
 GNS_edit_txt_dialog_response_cb (GtkDialog *dialog,
-                                   gint response_id,
-                                   gpointer user_data)
+                                 gint response_id,
+                                 gpointer user_data)
 {
   struct EditDialogContext *edc = user_data;
   GtkEntry *entry;
@@ -1720,7 +1710,6 @@ GNS_edit_txt_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -1736,7 +1725,6 @@ GNS_edit_dialog_txt_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'TXT' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -1799,12 +1787,13 @@ edit_dialog_vpn_validity_check (struct EditDialogContext *edc)
  * continuation.
  *
  * @param dialog editing dialog
+ * @param response_id action that caused the dialog to be closed
  * @param user_data the 'struct EditDialogContext'
  */
 void
 GNS_edit_vpn_dialog_response_cb (GtkDialog *dialog,
-                                   gint response_id,
-                                   gpointer user_data)
+                                 gint response_id,
+                                 gpointer user_data)
 {
   struct EditDialogContext *edc = user_data;
   GtkEntry *entry;
@@ -1845,7 +1834,6 @@ GNS_edit_vpn_dialog_response_cb (GtkDialog *dialog,
  * button depending on the validity of the value.
  *
  * @param entry editing widget
- * @param preedit new value
  * @param user_data the 'struct EditDialogContext' of the dialog
  */
 void
@@ -1861,7 +1849,6 @@ GNS_edit_dialog_vpn_peer_entry_changed_cb (GtkEditable *entry,
 /**
  * Run an GNS Edit dialog for an 'VPN' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
diff --git a/src/setup/gnunet-setup-gns-edit.h b/src/setup/gnunet-setup-gns-edit.h
index 6354baba..00f3d3ae 100644
--- a/src/setup/gnunet-setup-gns-edit.h
+++ b/src/setup/gnunet-setup-gns-edit.h
@@ -155,7 +155,6 @@ GNS_edit_dialog_a (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'AAAA' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -165,7 +164,6 @@ GNS_edit_dialog_aaaa (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'CNAME' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -175,7 +173,6 @@ GNS_edit_dialog_cname (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'LEHO' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -185,7 +182,6 @@ GNS_edit_dialog_leho (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'MX' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -195,7 +191,6 @@ GNS_edit_dialog_mx (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'NS' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -205,7 +200,6 @@ GNS_edit_dialog_ns (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'PKEY' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -215,7 +209,6 @@ GNS_edit_dialog_pkey (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'PTR' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -225,7 +218,6 @@ GNS_edit_dialog_ptr (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'SOA' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -235,7 +227,6 @@ GNS_edit_dialog_soa (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'SRV' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -245,7 +236,6 @@ GNS_edit_dialog_srv (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'TXT' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
@@ -255,7 +245,6 @@ GNS_edit_dialog_txt (struct EditDialogContext *edc);
 /**
  * Run an GNS Edit dialog for an 'VPN' Record.
  *
- * @param cont continuation to call when done
  * @param edc editing context to use
  */
 void
diff --git a/src/setup/gnunet-setup-gns.c b/src/setup/gnunet-setup-gns.c
index 76608979..d35231c3 100644
--- a/src/setup/gnunet-setup-gns.c
+++ b/src/setup/gnunet-setup-gns.c
@@ -1222,8 +1222,8 @@ GNUNET_setup_gns_popup_edit_button_activate_cb (GtkWidget *widget,
  * The user has selected a new record type.  Update the
  * model and then start the 'edit' dialog.
  *
- * @param renderer updated renderer
- * @param path the path identifying the edited cell
+ * @param text renderer updated renderer
+ * @param path_string the path identifying the edited cell
  * @param new_text updated text
  * @param user_data unused
  */
@@ -1720,10 +1720,10 @@ zone_sync_proc (void *cls)
  * Function called for each record in the current zone.  Update the
  * widgets accordingly. 
  *
- * @param NULL
+ * @param cls NULL
  * @param zone_key private key of the zone
  * @param name name that is being mapped (at most 255 characters long)
- * @param rd_count number of entries in 'rd' array
+ * @param rd_count number of entries in @a rd array
  * @param rd array of records with data to store
  */
 static void
diff --git a/src/statistics/gnunet-statistics-gtk.c b/src/statistics/gnunet-statistics-gtk.c
index 378fd809..df42e978 100644
--- a/src/statistics/gnunet-statistics-gtk.c
+++ b/src/statistics/gnunet-statistics-gtk.c
@@ -171,7 +171,7 @@ get_object (const char *name)
 /**
  * Actually draw a plot based on collected data.
  *
- * @param widget size and style information for the plot
+ * @param box_name name of the widget to update
  * @param info what to draw
  */
 static void