Update documentation:

* modify ubuntu Gnome Fallback to current package
* add hint for disable 3D effects and shadows

docs/manual/execution/maven/java-DSL.adoc

@@ -271,5 +271,5 @@ Now you can execute *test* phase and enjoy the successful execution of the test.
 [[java-dsl-https]]
 ===== HTTPS-Sites
 
-As workaround for issue https://github.com/ConSol/sakuli/issues/131[#131] you can follow the intructions of <<sahi-https>> and copy afterwards the files from `java-example/target/classes/sahi/userdata/certs` to `java-example/src/main/resources/sahi/userdata/certs`. This will copy the trusted certificates when building the project and allows a clean run. Also see <<sahi-https-automatic-certificate-usage>> which files have to been copied for running the tests on different host.
+As workaround for issue https://github.com/ConSol/sakuli/issues/131[#131] you can follow the instructions of <<sahi-https>> and copy afterwards the files from `java-example/target/classes/sahi/userdata/certs` to `java-example/src/main/resources/sahi/userdata/certs`. This will copy the trusted certificates when building the project and allows a clean run. Also see <<sahi-https-automatic-certificate-usage>> which files have to been copied for running the tests on different host.
 

docs/manual/execution/native/linux-native-headless.adoc

@@ -39,7 +39,7 @@ Starting applications specified in __HOME__/.vnc/xstartup
 Log file is __HOME__/.vnc/sakulidemo:1.log
 ----
 
-`.vnc/xstartup` controls what to start within a xvnc session. Do not touch this file on OpenSUSE; on *Ubuntu* you have to replace its content with the following lines (because you are using *gnome-session-fallback*, aren't you…?):
+`.vnc/xstartup` controls what to start within a xvnc session. Do not touch this file on OpenSUSE; on *Ubuntu* you have to replace its content with the following lines (because you are using <<gnome-session-flashback>>, aren't you…?):
 
 [source,bash]
 ----

docs/manual/execution/native/linux-troubleshooting.adoc

@@ -1,21 +1,31 @@
 
 :imagesdir: ../../../images
 
+[[linux-troubleshooting]]
 ===== Troubleshooting
 [#git-edit-section]
 :page-path: docs/manual/execution/native/linux-troubleshooting.adoc
 git-link:{page-path}{git-view} | git-link:{page-path}{git-edit}
 
 If you have some errors with your Linux installation, you can check the following points:
 
-[[gnome-session-fallback]]
-====== Install GNOME session fallback theme
+[[gnome-session-flashback]]
+====== Install GNOME session flashback theme
 
-Sakuli can test on Unity, of course - but https://apps.ubuntu.com/cat/applications/gnome-session-fallback/[gnome-session-fallback] is more than sufficient…
+NOTE: Before Ubuntu 16.04 the package name was `gnome-session-fallback`
 
-`sudo apt-get install gnome-session-fallback`
+Sakuli can test on Unity, of course - but https://wiki.ubuntuusers.de/GNOME_Flashback[gnome-session-flashback] is more than sufficient and has the advantage that 3D effects and shadowing won't break your test.
 
-After the installation, relogin and select the desktop environment *GNOME Flashback (Metacity)*:
+Install and set `gnome-seesion-flashback` as default:
+[source,bash]
+----
+    apt-get update
+    apt-get install -y gnome-session-flashback
+    echo "[SeatDefaults]" >> /etc/lightdm/lightdm.conf
+    echo "user-session=gnome-flashback-metacity" >> /etc/lightdm/lightdm.conf
+----
+
+After the installation, relogin/restart and ensure that the desktop environment *GNOME Flashback (Metacity)* is selected:
 
 image:u_theme_select.jpg[fallback]
 

docs/manual/execution/native/linux.adoc

@@ -43,14 +43,15 @@ You can run Sakuli on physical as well as on virtual Linux machines.
 * Run Sakuli with a dedicated user
 * Sakuli needs a reliable and predictable desktop environment: make sure that there are no pop-up windows of services or applications
 * If Sakuli is running within a VM, change the desktop resolution to a fixed value (e.g. 1024x768) and disable any auto-resizing mechanisms of the guest display. This ensures that the guest's resolution does not change in case that you resize its window.
-* Other optional steps see <<gnome-session-fallback>>.
-* the client should *not* have more than one physical screen
+* Ensure that now 3D effects or shadowing break your test. For Ubuntu e.g. it's recommended to use <<gnome-session-flashback,`gnome-session-flashback`>> theme.
+* Ensure that the client should have only *ONE* physical screen.
+* Other optional steps see <<linux-troubleshooting>>.
 
 ====== Sakuli installation
 
 * Download the *Sakuli Installer* from http://labs.consol.de/sakuli/install[http://labs.consol.de/sakuli/install]
-* current *development* snapshot = `sakuli-vX.X.X-SNAPSHOT-installer.jar`
-* current *stable* version = `sakuli-vX.X.X-installer.jar` (recommended)
+** current *development* snapshot = `sakuli-vX.X.X-SNAPSHOT-installer.jar`
+** current *stable* version = `sakuli-vX.X.X-installer.jar` (recommended)
 
 Execute `java -jar sakuli-vX.X.X-installer.jar` to start the installer:
 

docs/manual/execution/native/windows-troubleshooting.adoc

@@ -1,12 +1,15 @@
 
 :imagesdir: ../../../images
+
+[[windows-troubleshooting]]
 ===== Troubleshooting
 [#git-edit-section]
 :page-path: docs/manual/execution/native/windows-troubleshooting.adoc
 git-link:{page-path}{git-view} | git-link:{page-path}{git-edit}
 
 If you have some errors with your Windows installation, you can check the following points:
 
+[[windows-classic-theme]]
 ====== Change Windows theme and title bar colors
 
 Windows 7 comes by default with an "aero" theme, which is quite awkward for Sikuli, because there are many transparency effects which cause window elements to change their appearance dependend on the elements below. For that, change the theme to "Windows Classic".

docs/manual/execution/native/windows.adoc

@@ -42,13 +42,15 @@ You can run Sakuli on physical as well as on virtual Linux machines.
 * Run Sakuli with a dedicated user
 * Sakuli needs a reliable and predictable desktop environment: make sure that there are no pop-up windows of services or applications
 * If Sakuli is running within a VM, change the desktop resolution to a fixed value (e.g. 1024x768) and disable any auto-resizing mechanisms of the guest display. This ensures that the guest's resolution does not change in case that you resize its window.
-* the client should *not* have more than one physical screen
+* Ensure that now 3D effects or shadowing break your test. For Window 7 e.g. it's recommended to use <<windows-classic-theme, Windos Classic theme>>.
+* Ensure that the client should have only *ONE* physical screen.
+* Other optional steps see <<windows-troubleshooting>>.
 
 ====== Sakuli installation
 
 * Download the *Sakuli Installer* from http://labs.consol.de/sakuli/install[http://labs.consol.de/sakuli/install]
-* current *development* snapshot = `sakuli-vX.X.X-SNAPSHOT-installer.jar`
-* current *stable* version = `sakuli-vX.X.X-installer.jar` (recommended)
+** current *development* snapshot = `sakuli-vX.X.X-SNAPSHOT-installer.jar`
+** current *stable* version = `sakuli-vX.X.X-installer.jar` (recommended)
 
 Double-click on the downloaded .jar file to start the installer: