diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 1d9dc14300..383728d0b5 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -15545,18 +15545,18 @@ union_with_clip (GtkWidget *widget,
   gdk_rectangle_union (&widget_clip, clip, clip);
 }
 
-/**
+/*
  * _gtk_widget_set_simple_clip:
- * @widget: 
+ * @widget: a #GtkWidget
  *
  * This is a convenience function for gtk_widget_set_clip(), if you
  * just want to set the clip for @widget based on its allocation,
  * CSS properties and - if the widget is a #GtkContainer - its
  * children. gtk_widget_set_allocation() must have been called
  * and all children must have been allocated with
- * gtk_widget_size_allocate() before calling this function. It is
- * therefor a good idea to call this function last in your
- * implementation of GtkWidget::size_allocate().
+ * gtk_widget_size_allocate() before calling this function.
+ * It is therefore a good idea to call this function last in
+ * your implementation of GtkWidget::size_allocate().
  *
  * If your widget overdraws its contents, you cannot use this
  * function and must call gtk_widget_set_clip() yourself.