Doc: changes to rotation and new button in scripting

Reviewed-by: ckamm

1 files changed, 27 insertions, 7 deletions

diff --git a/doc/simulator.qdoc b/doc/simulator.qdoc
index 9631f8d..f064381 100644
--- a/doc/simulator.qdoc
+++ b/doc/simulator.qdoc
@@ -650,7 +650,13 @@
     application software must deploy to multiple devices, ensure that your
     application layout is properly usable in all orientations.
 
-    Click the rotation buttons to change the orientation of the display.
+    Applications can auto-rotate the screen according to the current device
+    orientation or lock the screen into a particular orientation. Click the rotation
+    buttons to change the orientation of the device. When the \gui {Rotate screen}
+    check box is selected, the screen is auto-rotated to match the orientation of
+    the device. However, some devices do not support screen rotation for all possible
+    orientations. Deselect the check box to rotate the device without changing
+    the orientation of the screen.
 
     \image qt-simulator-view-rotation.png "Rotation buttons"
 
@@ -778,6 +784,9 @@
 
     Example scripts are located in \tt{scripts/examples/}.
 
+    To open the folder that contains the scripts in a file browser,
+    select \gui {Open Folder}.
+
     \section1 Running Scripts
 
     To run a script:
@@ -1003,11 +1012,21 @@
     the z axis (that is, upwards). This is the proper acceleration the device experiences
     relative to freefall.
 
-    To simulate movement of the device, use the sliders to specify values for the x, y,
-    and z axis in the \gui {Accelerometer x}, \gui {Accelerometer y}, and \gui {Accelerometer z}
-    fields.  You can also click or right-click the image of the device in the \gui Accelerometer
-    field and hold down the mouse button to rotate the image. The accelerometer values change
-    accordingly.
+    To simulate movement of the device:
+
+    \list
+
+        \o Click or right-click the image of the device in the \gui Accelerometer
+        field and hold down the mouse button to rotate the image.
+
+        \o Click the rotation buttons buttons to rotate the image:
+        \image qt-simulator-sensors-rotation.png "Rotation buttons in Sensors view"
+
+        \o Use the sliders to specify values for the x, y, and z axis in the
+        \gui {Accelerometer x}, \gui {Accelerometer y}, and \gui {Accelerometer z}
+        fields.
+
+    \endlist
 
     \section1 Device Rotation
 
@@ -1018,7 +1037,8 @@
     \image sensors-rotation.jpg "Rotation"
 
     Click or right-click the image of the device in the \gui Accelerometer field and hold down
-    the mouse button to apply the angles to the device. This allows you to test how the application
+    the mouse button to apply the angles to the device. You can also click the rotation buttons.
+    This allows you to test how the application
     handles the interaction related to rotating the device.
 
     For more information about how the angles are applied, see