From fb4f21613b30a0b72a0af3c9421c68846781c857 Mon Sep 17 00:00:00 2001
From: Matthew Brush <codebrainz@codebrainz.ca>
Date: Thu, 22 Sep 2011 23:10:45 -0700
Subject: [PATCH] Document that the widget param for ui_lookup_widget() is no
 longer.

Cast it to void to avoid warnings and tell other programmers.
---
 src/ui_utils.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/ui_utils.c b/src/ui_utils.c
index fd473da2..44e77876 100644
--- a/src/ui_utils.c
+++ b/src/ui_utils.c
@@ -2219,6 +2219,10 @@ void ui_widget_set_tooltip_text(GtkWidget *widget, const gchar *text)
  * Call it with the toplevel widget in the component (i.e. a window/dialog),
  * or alternatively any widget in the component, and the name of the widget
  * you want returned.
+ *
+ * @note Since 0.21 the @a widget parameter is not used and can be set
+ * to NULL if you like.
+ *
  * @param widget Widget with the @a widget_name property set.
  * @param widget_name Name to lookup.
  * @return The widget found.
@@ -2230,6 +2234,8 @@ GtkWidget *ui_lookup_widget(GtkWidget *widget, const gchar *widget_name)
 {
 	GtkWidget *found_widget;
 
+	(void) widget; /* not used anymore */
+
 	g_return_val_if_fail(widget_name != NULL, NULL);
 
 	found_widget = GTK_WIDGET(interface_get_object(widget_name));