diff --git a/ChangeLog b/ChangeLog
index fc182a4531..1972d8df4e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-09-10  Sven Neumann  <sven@gimp.org>
+
+	* libgimpwidgets/gimppreview.c
+	* libgimpwidgets/gimppreviewarea.c: documented new functions.
+
 2004-09-09  Sven Neumann  <sven@gimp.org>
 
 	* libgimp/gimpdrawablepreview.c
diff --git a/devel-docs/ChangeLog b/devel-docs/ChangeLog
index d821baf37d..d57dcc54d6 100644
--- a/devel-docs/ChangeLog
+++ b/devel-docs/ChangeLog
@@ -1,3 +1,10 @@
+2004-09-10  Sven Neumann  <sven@gimp.org>
+
+	* libgimpwidgets/libgimpwidgets-sections.txt
+	* libgimpwidgets/tmpl/gimppreview.sgml	
+	* libgimpwidgets/tmpl/gimppreviewarea.sgml: updated for new
+	preview APIs.
+
 2004-09-07  Sven Neumann  <sven@gimp.org>
 
 	* libgimpwidgets/libgimpwidgets-sections.txt
diff --git a/devel-docs/libgimpwidgets/libgimpwidgets-sections.txt b/devel-docs/libgimpwidgets/libgimpwidgets-sections.txt
index 25b5dc0364..97b22181ee 100644
--- a/devel-docs/libgimpwidgets/libgimpwidgets-sections.txt
+++ b/devel-docs/libgimpwidgets/libgimpwidgets-sections.txt
@@ -785,6 +785,7 @@ gimp_preview_area_blend
 gimp_preview_area_mask
 gimp_preview_area_set_offsets
 gimp_preview_area_set_cmap
+gimp_preview_area_set_max_size
 gimp_preview_area_menu_popup
 <SUBSECTION Standard>
 GimpPreviewAreaClass
@@ -803,6 +804,7 @@ GIMP_PREVIEW_AREA_GET_CLASS
 GimpPreview
 gimp_preview_get_update
 gimp_preview_set_update
+gimp_preview_set_bounds
 gimp_preview_get_size
 gimp_preview_get_position
 gimp_preview_draw
diff --git a/devel-docs/libgimpwidgets/tmpl/gimppreview.sgml b/devel-docs/libgimpwidgets/tmpl/gimppreview.sgml
index 9170a8b931..ee0c256880 100644
--- a/devel-docs/libgimpwidgets/tmpl/gimppreview.sgml
+++ b/devel-docs/libgimpwidgets/tmpl/gimppreview.sgml
@@ -55,6 +55,18 @@ GimpPreview
 @update: 
 
 
+<!-- ##### FUNCTION gimp_preview_set_bounds ##### -->
+<para>
+
+</para>
+
+@preview: 
+@xmin: 
+@ymin: 
+@xmax: 
+@ymax: 
+
+
 <!-- ##### FUNCTION gimp_preview_get_size ##### -->
 <para>
 
diff --git a/devel-docs/libgimpwidgets/tmpl/gimppreviewarea.sgml b/devel-docs/libgimpwidgets/tmpl/gimppreviewarea.sgml
index 2da3654e76..4fc31d48dd 100644
--- a/devel-docs/libgimpwidgets/tmpl/gimppreviewarea.sgml
+++ b/devel-docs/libgimpwidgets/tmpl/gimppreviewarea.sgml
@@ -127,6 +127,16 @@ GimpPreviewArea
 @num_colors: 
 
 
+<!-- ##### FUNCTION gimp_preview_area_set_max_size ##### -->
+<para>
+
+</para>
+
+@area: 
+@width: 
+@height: 
+
+
 <!-- ##### FUNCTION gimp_preview_area_menu_popup ##### -->
 <para>
 
diff --git a/libgimpwidgets/gimppreview.c b/libgimpwidgets/gimppreview.c
index 7e7bd5be3e..bd1a09d98a 100644
--- a/libgimpwidgets/gimppreview.c
+++ b/libgimpwidgets/gimppreview.c
@@ -915,6 +915,10 @@ gimp_preview_get_update (GimpPreview *preview)
  * @xmax:
  * @ymax:
  *
+ * Sets the lower and upper limits for the previewed area. The
+ * difference between the upper and lower value is used to set the
+ * maximum size of the #GimpPreviewArea used in the @preview.
+ *
  * Since: GIMP 2.2
  **/
 void
@@ -961,7 +965,7 @@ gimp_preview_get_size (GimpPreview *preview,
 }
 
 /**
- * gimp_preview_get_posistion:
+ * gimp_preview_get_position:
  * @preview: a #GimpPreview widget
  * @x:       return location for the horizontal offset
  * @y:       return location for the vertical offset
diff --git a/libgimpwidgets/gimppreviewarea.c b/libgimpwidgets/gimppreviewarea.c
index c3ca1357fd..0241f96bb1 100644
--- a/libgimpwidgets/gimppreviewarea.c
+++ b/libgimpwidgets/gimppreviewarea.c
@@ -1666,9 +1666,14 @@ gimp_preview_area_set_cmap (GimpPreviewArea *area,
 
 /**
  * gimp_preview_area_set_max_size:
- * @area: a #GimpPreviewArea widget
- * @width:
- * @height:
+ * @area:   a #GimpPreviewArea widget
+ * @width:  the maximum width in pixels or -1 to unset the limit
+ * @height: the maximum height in pixels or -1 to unset the limit
+ *
+ * Usually a #GimpPreviewArea fills the size that it is
+ * allocated. This funtion allows you to limit the preview area to a
+ * maximum size. If a larger size is allocated for the widget, the
+ * preview will draw itself centered into the allocated area.
  *
  * Since: GIMP 2.2
  **/