From 1499455d25ac026f4b6333ba0b94ea125f3a604b Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Mon, 26 May 2003 22:58:28 +0000
Subject: [PATCH] Document allowed values for adjustments which are used in
 scrollbars.

	* gtk/tmpl/gtkadjustment.sgml: Document allowed values for
	adjustments which are used in scrollbars.  (#108448, Ernst Lippe)
---
 docs/reference/ChangeLog                   | 3 +++
 docs/reference/gtk/tmpl/gtkadjustment.sgml | 9 ++++++++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index c651325cd3..08b773371b 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,8 @@
 2003-05-27  Matthias Clasen  <maclas@gmx.de>
 
+	* gtk/tmpl/gtkadjustment.sgml: Document allowed values for
+	adjustments which are used in scrollbars.  (#108448, Ernst Lippe)
+
 	* gtk/tmpl/gtkradiomenuitem.sgml: Fix example.  (#113604, 
 	Julien Moutte)
 
diff --git a/docs/reference/gtk/tmpl/gtkadjustment.sgml b/docs/reference/gtk/tmpl/gtkadjustment.sgml
index aac7fc7949..3d4a86ec3e 100644
--- a/docs/reference/gtk/tmpl/gtkadjustment.sgml
+++ b/docs/reference/gtk/tmpl/gtkadjustment.sgml
@@ -104,7 +104,14 @@ Creates a new #GtkAdjustment.
 
 <!-- ##### FUNCTION gtk_adjustment_set_value ##### -->
 <para>
-Sets the #GtkAdjustment value.
+Sets the #GtkAdjustment value. The value is clamped to lie between
+<literal>adjustment-&gt;lower</literal> and
+<literal>adjustment-&gt;upper</literal>.
+</para>
+<para>
+Note that for adjustments which are used in a #GtkScrollbar, the effective
+range of allowed values goes from <literal>adjustment-&gt;lower</literal> to
+<literal>adjustment-&gt;upper - adjustment-&gt;page_size</literal>.
 </para>
 
 @adjustment: a #GtkAdjustment.