Merge remote-tracking branch 'origin/master' into api_changes

Change-Id: I89dc2e193bd01624c1fb50484610d516e39b1538

1 files changed, 6 insertions, 1 deletions

diff --git a/src/gui/kernel/qevent.cpp b/src/gui/kernel/qevent.cpp
index f1bf07635c..7b84f4a982 100644
--- a/src/gui/kernel/qevent.cpp
+++ b/src/gui/kernel/qevent.cpp
@@ -3863,11 +3863,16 @@ QTouchEvent::TouchPoint::InfoFlags QTouchEvent::TouchPoint::flags() const
 }
 
 /*!
-  Returns the raw, unfiltered positions for the touch point. The positions are in screen coordinates.
+  Returns the raw, unfiltered positions for the touch point. The positions are in native screen coordinates.
   To get local coordinates you can use mapFromGlobal() of the QWindow returned by QTouchEvent::window().
 
   \note Returns an empty list if the touch device's capabilities do not include QTouchDevice::RawPositions.
 
+  \note Native screen coordinates refer to the native orientation of the screen which, in case of
+  mobile devices, is typically portrait. This means that on systems capable of screen orientation
+  changes the positions in this list will not reflect the current orientation (unlike pos(),
+  screenPos(), etc.) and will always be reported in the native orientation.
+
   \sa QTouchDevice::capabilities(), device(), window()
   */
 QList<QPointF> QTouchEvent::TouchPoint::rawScreenPositions() const