diff --git a/ChangeLog b/ChangeLog
index 54335a4d42..4f008420dc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2004-09-12  DindinX  <david@dindinx.org>
+
+	* libgimp/gimppixelrgn.c: some more fixes by nomis.
+
 2004-09-12  DindinX  <david@dindinx.org>
 
 	* libgimp/gimppixelrgn.c: nomis helped me to make some correction to
diff --git a/libgimp/gimppixelrgn.c b/libgimp/gimppixelrgn.c
index d8e006b3aa..6cd8bccb8d 100644
--- a/libgimp/gimppixelrgn.c
+++ b/libgimp/gimppixelrgn.c
@@ -77,11 +77,14 @@ static void     gimp_pixel_rgn_configure  (GimpPixelRgnHolder   *prh,
  * gimp_pixel_rgn_init:
  * @pr:        a pointer to a #GimpPixelRgn variable.
  * @drawable:  the #GimpDrawable the new region will be attached to.
- * @x:         the x coordinate of the top-left pixel of the region in the @drawable.
- * @y:         the y coordinate of the top-left pixel of the region in the @drawable.
+ * @x:         the x coordinate of the top-left pixel of the region in the
+ *             @drawable.
+ * @y:         the y coordinate of the top-left pixel of the region in the
+ *             @drawable.
  * @width:     the width of the region.
  * @height:    the height of the region.
- * @dirty:     a #gboolean indicating whether the @drawable should be marked as "dirty".
+ * @dirty:     a #gboolean indicating whether the @drawable should be marked
+ *             as "dirty".
  * @shadow:    a #gboolean indicating whether the region is attached to the
  *             shadow tiles or the real @drawable tiles.
  *
@@ -117,8 +120,10 @@ gimp_pixel_rgn_init (GimpPixelRgn *pr,
 /**
  * gimp_pixel_rgn_resize:
  * @pr:      a pointer to a previously initialized #GimpPixelRgn.
- * @x:       the x coordinate of the new position of the region's top-left corner.
- * @y:       the y coordinate of the new position of the region's top-left corner.
+ * @x:       the x coordinate of the new position of the region's
+ *           top-left corner.
+ * @y:       the y coordinate of the new position of the region's
+ *           top-left corner.
  * @width:   the new width of the region.
  * @height:  the new height of the region.
  *
@@ -644,17 +649,17 @@ gimp_pixel_rgn_set_rect (GimpPixelRgn *pr,
  * @nrgns: the number of regions to register.
  * @prs:   an array of @nrgns pointers to initialized #GimpPixelRgn.
  *
- * This function is hard to describe by itself.  It takes a number of
- * initialized regions of the same size and provides a pixel region iterator
- * the iterator can be used to iterate over the registered pixel regions.
- * While iterating the registered pixel regions will cover subsets of the
- * original pixel regions.
+ * It takes a number of initialized regions of the same size and provides a
+ * pixel region iterator the iterator can be used to iterate over the
+ * registered pixel regions.  While iterating the registered pixel regions will
+ * cover subsets of the original pixel regions, chosen for optimized access to
+ * the image data.
  * 
- * The subsets are choosen to use the tile cache as well as possible.
- *
  * Note that the given regions themselves are changed by this function, so
  * they are resized to the first subsets.
  * 
+ * This function has to be used together with gimp_pixel_rgns_process in a loop.
+ *
  * Returns: a #gpointer to a regions iterator.
  **/
 gpointer