[gtk+] Adapt gtk_widget_set_name() docs to style context.

[Carlos Garnacho <carlosg src gnome org>]

commit d7dc12d30117374df300102052350085fe70d132
Author: Carlos Garnacho <carlosg gnome org>
Date:   Sat Dec 18 11:26:48 2010 +0100

    Adapt gtk_widget_set_name() docs to style context.

 gtk/gtkwidget.c |   15 +++++++++------
 1 files changed, 9 insertions(+), 6 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 214a1cf..ca61f04 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -6697,12 +6697,15 @@ gtk_widget_device_is_shadowed (GtkWidget *widget,
  * @name: name for the widget
  *
  * Widgets can be named, which allows you to refer to them from a
- * gtkrc file. You can apply a style to widgets with a particular name
- * in the gtkrc file. See the documentation for gtkrc files (on the
- * same page as the docs for #GtkRcStyle).
- *
- * Note that widget names are separated by periods in paths (see
- * gtk_widget_path()), so names with embedded periods may cause confusion.
+ * CSS file. You can apply a style to widgets with a particular name
+ * in the CSS file. See the documentation for the CSS syntax (on the
+ * same page as the docs for #GtkStyleContext).
+ *
+ * Note that the CSS syntax has certain special characters to delimit
+ * and represent elements in a selector (period, &num;, &gt;, &ast;...),
+ * so using these will make your widget impossible to match by name.
+ * Any combination of alphanumeric symbols, dashes and underscores will
+ * suffice.
  **/
 void
 gtk_widget_set_name (GtkWidget	 *widget,