Fix Flickable::visibleArea.xPosition, Flickable::visibleArea.yPosition docs

Task-number: QTBUG-9499

1 files changed, 4 insertions, 2 deletions

diff --git a/src/declarative/graphicsitems/qdeclarativeflickable.cpp b/src/declarative/graphicsitems/qdeclarativeflickable.cpp
index fb22429..8459245 100644
--- a/src/declarative/graphicsitems/qdeclarativeflickable.cpp
+++ b/src/declarative/graphicsitems/qdeclarativeflickable.cpp
@@ -403,8 +403,10 @@ void QDeclarativeFlickablePrivate::updateBeginningEnd()
 
     These properties describe the position and size of the currently viewed area.
     The size is defined as the percentage of the full view currently visible,
-    scaled to 0.0 - 1.0.  The page position is in the range 0.0 (beginning) to
-    size ratio (end), i.e. yPosition is in the range 0.0 - heightRatio.
+    scaled to 0.0 - 1.0.  The page position is usually in the range 0.0 (beginning) to
+    1.0 minus size ratio (end), i.e. yPosition is in the range 0.0 to 1.0-heightRatio.
+    However, it is possible for the contents to be dragged outside of the normal
+    range, resulting in the page positions also being outside the normal range.
 
     These properties are typically used to draw a scrollbar, for example:
     \code