[MPlayer-cvslog] r36197 - in trunk/gui/dialog: fileselect.c url.c

[ib]

Author: ib
Date: Tue Apr 30 15:10:27 2013
New Revision: 36197

Log:
Revise signal callback function doxygen comments.

Explain the function instead of the signal.

Modified:
   trunk/gui/dialog/fileselect.c
   trunk/gui/dialog/url.c

Modified: trunk/gui/dialog/fileselect.c
==============================================================================
--- trunk/gui/dialog/fileselect.c	Tue Apr 30 14:48:41 2013	(r36196)
+++ trunk/gui/dialog/fileselect.c	Tue Apr 30 15:10:27 2013	(r36197)
@@ -527,7 +527,8 @@ static void fs_Ok_released(GtkButton *bu
 }
 
 /**
- * @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

Modified: trunk/gui/dialog/url.c
==============================================================================
--- trunk/gui/dialog/url.c	Tue Apr 30 14:48:41 2013	(r36196)
+++ trunk/gui/dialog/url.c	Tue Apr 30 15:10:27 2013	(r36197)
@@ -39,10 +39,15 @@ static GtkWidget *urlEntry;
 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)
 {