Un-doc-commentize non-exported functions

svn path=/trunk/; revision=21979

ChangeLog

+2008-12-28  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtkwidget.c:
+	* gtk/gtktextutil.c: Un-doc-commentize non-exported functions
+	to make gtk-doc happy.
+
 2008-12-28  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/gtkscale.c:

gtk/gtktextutil.c

@@ -105,7 +105,7 @@ activate_cb (GtkWidget *menu_item,
   (* info->func) (buf, info->data);
 }
 
-/**
+/*
  * _gtk_text_util_append_special_char_menuitems
  * @menushell: a #GtkMenuShell
  * @callback:  call this when an item is chosen
@@ -119,7 +119,7 @@ activate_cb (GtkWidget *menu_item,
  * become public sometime, but it probably needs more thought first.
  * e.g. maybe there should be a way to just get the list of items,
  * instead of requiring the menu items to be created.
- **/
+ */
 void
 _gtk_text_util_append_special_char_menuitems (GtkMenuShell              *menushell,
                                               GtkTextUtilCharChosenFunc  func,
@@ -194,14 +194,16 @@ limit_layout_lines (PangoLayout *layout)
     }
 }
 
-/**
+/*
  * _gtk_text_util_create_drag_icon
  * @widget: #GtkWidget to extract the pango context
  * @text: a #gchar to render the icon
  * @len: length of @text, or -1 for NUL-terminated text
  *
  * Creates a drag and drop icon from @text.
- **/
+ *
+ * Returns: a #GdkPixmap to use as DND icon
+ */
 GdkPixmap *
 _gtk_text_util_create_drag_icon (GtkWidget *widget, 
                                  gchar     *text,
@@ -401,7 +403,7 @@ layout_get_char_width (PangoLayout *layout)
   return width;
 }
 
-/**
+/*
  * _gtk_text_util_get_block_cursor_location
  * @layout: a #PangoLayout
  * @index: index at which cursor is located
@@ -410,8 +412,8 @@ layout_get_char_width (PangoLayout *layout)
  * character
  *
  * Returns: whether cursor should actually be drawn as a rectangle.
- * It may not be the case if character at index is invisible.
- **/
+ *     It may not be the case if character at index is invisible.
+ */
 gboolean
 _gtk_text_util_get_block_cursor_location (PangoLayout    *layout,
 					  gint            index,

gtk/gtkwidget.c

@@ -8071,14 +8071,14 @@ _gtk_widget_peek_colormap (void)
   return NULL;
 }
 
-/**
+/*
  * _gtk_widget_set_pointer_window:
  * @widget: a #GtkWidget.
  * @pointer_window: the new pointer window.
  *
  * Sets pointer window for @widget.  Does not ref @pointer_window.
  * Actually stores it on the #GdkScreen, but you don't need to know that.
- **/
+ */
 void
 _gtk_widget_set_pointer_window (GtkWidget *widget,
                                 GdkWindow *pointer_window)
@@ -8094,13 +8094,13 @@ _gtk_widget_set_pointer_window (GtkWidget *widget,
     }
 }
 
-/**
+/*
  * _gtk_widget_get_pointer_window:
  * @widget: a #GtkWidget.
  *
  * Return value: the pointer window set on the #GdkScreen @widget is attached
  * to, or %NULL.
- **/
+ */
 GdkWindow *
 _gtk_widget_get_pointer_window (GtkWidget *widget)
 {