Un-doc-commentize non-exported functions

svn path=/trunk/; revision=21979

diff --git a/ChangeLog b/ChangeLog
index 2fc68fca517e731a7242576d762ccbff325e9a2c..8fb9fa285d110543a7fccdc1dfb5a8df9124c0fc 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+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:

diff --git a/gtk/gtktextutil.c b/gtk/gtktextutil.c
index 145ef2b5fe17047d7cda24029d3fc4e220425f8d..3995bd174ba829572108f3eb0ad9805ccdd5172c 100644 (file)
--- a/gtk/gtktextutil.c
+++ b/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,

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index a7f42d35f935407d436fcf7c55e1841ca2e26486..ff02b79a2c840c625ba6a367255064a60f2e509e 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/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)
 {