# HG changeset patch
# User ib
# Date 1367327427 0
# Node ID 236d31040749cfc941fdd7ad06c3889829d75b38
# Parent  0fade14b5df1cdefb7b681597ff7049547ae084d
Revise signal callback function doxygen comments.

Explain the function instead of the signal.

diff -r 0fade14b5df1 -r 236d31040749 gui/dialog/fileselect.c
--- a/gui/dialog/fileselect.c	Tue Apr 30 12:48:41 2013 +0000
+++ b/gui/dialog/fileselect.c	Tue Apr 30 13:10:27 2013 +0000
@@ -527,7 +527,8 @@
 }
 
 /**
- * @brief The "key-release-event" signal user function.
+ * @brief Handle the escape, return and backspace key depending on the
+ *        @a widget it has been pressed on.
  *
  * @param widget object which received the signal
  * @param event GdkEventKey which triggered the signal
diff -r 0fade14b5df1 -r 236d31040749 gui/dialog/url.c
--- a/gui/dialog/url.c	Tue Apr 30 12:48:41 2013 +0000
+++ b/gui/dialog/url.c	Tue Apr 30 13:10:27 2013 +0000
@@ -39,10 +39,15 @@
 static GList *urlEntries;
 
 /**
- * @brief The "clicked" signal user function.
+ * @brief Add the entered URL to the URL list and stream it,
+ *        if the button clicked is the OK button
+ *
+ * @note If the scheme is missing, http is assumed (and added).
  *
  * @param button object which received the signal
  * @param user_data user data set when the signal handler was connected
+ *
+ * @note The button is determined by checking @a user_data.
  */
 static void button_clicked(GtkButton *button, gpointer user_data)
 {