From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Mon, 29 Dec 2008 04:50:15 +0000 (+0000)
Subject: Un-doc-commentize non-exported functions
X-Git-Url: http://pileus.org/git/?a=commitdiff_plain;h=a7e5938f58f8baab2409ecdfe920b5d07a557203;p=~andy%2Fgtk

Un-doc-commentize non-exported functions

svn path=/trunk/; revision=21979
---

diff --git a/ChangeLog b/ChangeLog
index 2fc68fca5..8fb9fa285 100644
--- 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 145ef2b5f..3995bd174 100644
--- 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 a7f42d35f..ff02b79a2 100644
--- 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)
 {