Miscellaneous docs improvements

Just the usual pre-release doc fixups.

diff --git a/gtk/gtksnapshot.c b/gtk/gtksnapshot.c
index 4d367948e953cdda3e7d8df5940438aa11623e39..6418aefd0f5dd85fef921229b5100760d102e059 100644 (file)
--- a/gtk/gtksnapshot.c
+++ b/gtk/gtksnapshot.c
@@ -44,11 +44,11 @@
  * a cairo context, and maintains a stack of render nodes and their associated
  * transformations.
  *
- * The node at the top of the stack is the the one that gtk_snapshot_append()
- * operates on. Use the gtk_snapshot_push() and gtk_snapshot_pop() functions to
- * change the current node.
+ * The node at the top of the stack is the the one that gtk_snapshot_append_…
+ * functions operate on. Use the gtk_snapshot_push_… functions and gtk_snapshot_pop()
+ * to change the current node.
  *
- * The typical way to obtain a #GtkSnapshot object is as an argument to
+ * The typical way to obtain a GtkSnapshot object is as an argument to
  * the #GtkWidget::snapshot vfunc. If you need to create your own GtkSnapshot,
  * use gtk_snapshot_new().
  */

diff --git a/gtk/gtkwidgetpaintable.c b/gtk/gtkwidgetpaintable.c
index d15b1cee4baf3ad13e0500c5d0920e399fe2c36e..5cae0afd442278009c1da210025b14d21a588316 100644 (file)
--- a/gtk/gtkwidgetpaintable.c
+++ b/gtk/gtkwidgetpaintable.c
@@ -31,26 +31,25 @@
  * @Title: GtkWidgetPaintable
  * @see_also: #GtkWidget, #GdkPaintable
  *
- * #GtkWidgetPaintable is an implementation of the #GdkPaintable interface 
+ * GtkWidgetPaintable is an implementation of the #GdkPaintable interface 
  * that allows displaying the contents of a #GtkWidget.
  *
- * #GtkWidgetPaintable will also take care of the widget not being in a
+ * GtkWidgetPaintable will also take care of the widget not being in a
  * state where it can be drawn (like when it isn't shown) and just draw
  * nothing or where it does not have a size (like when it is hidden) and
  * report no size in that case.
  *
- * Of course, #GtkWidgetPaintable allows you to monitor widgets for size
- * changes by emitting the GdkPaintable::invalidate-size signal whenever
+ * Of course, GtkWidgetPaintable allows you to monitor widgets for size
+ * changes by emitting the #GdkPaintable::invalidate-size signal whenever
  * the size of the widget changes as well as for visual changes by
- * emitting the GdkPaintable::invalidate-contents signal whenever the
+ * emitting the #GdkPaintable::invalidate-contents signal whenever the
  * widget changes.
  *
- * You can of course use a #GtkWidgetPaintable everywhere a
+ * You can of course use a GtkWidgetPaintable everywhere a
  * #GdkPaintable is allowed, including using it on a #GtkImage (or one
- * of its parents) that it was set on itself via
- * gtk_image_set_from_paintable(). The paintable will take care of recursion
- * when this happens.  
- * If you do this however, make sure to set the GtkImage:can-shrink property
+ * of its parents) that it was set on itself via gtk_image_set_from_paintable().
+ * The paintable will take care of recursion when this happens. If you do
+ * this however, make sure to set the #GtkImage:can-shrink property
  * to %TRUE or you might end up with an infinitely growing image.
  */
 struct _GtkWidgetPaintable