Merge remote-tracking branch 'origin/5.9.0' into 5.9

Change-Id: Iba6114263488d6bf84b255b38182904dc5880386

2 files changed, 32 insertions, 11 deletions

diff --git a/src/webengine/doc/src/qtwebengine-overview.qdoc b/src/webengine/doc/src/qtwebengine-overview.qdoc
index ff35b45cf..e180b22c0 100644
--- a/src/webengine/doc/src/qtwebengine-overview.qdoc
+++ b/src/webengine/doc/src/qtwebengine-overview.qdoc
@@ -1,6 +1,6 @@
 /****************************************************************************
 **
-** Copyright (C) 2016 The Qt Company Ltd.
+** Copyright (C) 2017 The Qt Company Ltd.
 ** Contact: https://www.qt.io/licensing/
 **
 ** This file is part of the documentation of the Qt Toolkit.
@@ -89,7 +89,7 @@
     \l{https://chromium.googlesource.com/chromium/src/+/master/docs/chromium_browser_vs_google_chrome.md}{overview}
     that is part of the documentation in the \l {Chromium Project} upstream source tree.
 
-    This version of Qt WebEngine is based on Chromium version 53.0.2785.148, with
+    This version of Qt WebEngine is based on Chromium version 56.0.2924.122, with
     additional security fixes from newer versions.
 
     \section2 Qt WebEngine Process
diff --git a/src/webengine/doc/src/qtwebengine-platform-notes.qdoc b/src/webengine/doc/src/qtwebengine-platform-notes.qdoc
index 06a4a53a9..2eeda6e8a 100644
--- a/src/webengine/doc/src/qtwebengine-platform-notes.qdoc
+++ b/src/webengine/doc/src/qtwebengine-platform-notes.qdoc
@@ -114,17 +114,18 @@
 
     \section1 Mac App Store Compatibility
 
-    By default, Qt WebEngine uses private \macos API, which might cause an application to be
-    rejected when submitted to the Mac App Store. To configure Qt WebEngine not to use these API
-    calls, Qt has to be reconfigured with the \c -appstore-compliant switch.
-
-    However, this will cause some behavioral changes, such as:
+    Applications using Qt WebEngine are not compatible with the Mac App Store, because:
 
     \list
-        \li The \macos Kill Ring functionality will no longer work (emacs-like copy pasting).
-        \li Certain Chromium sandboxing cleanup is not done.
-        \li Text areas will be painted with a different style.
-        \li Text fields might be painted with a different style on Mountain Lion (\macos 10.8).
+        \li The Chromium part of the code uses several private API methods, which are prohibited by
+            the App Store.
+        \li Applications submitted to the App Store must be code-signed with the App Sandbox feature
+            enabled. The App Sandbox feature interferes with Chromium's own sandbox
+            initialization, which results in Chromium not being properly initialized. This also
+            ties in with the private API usage. Furthermore, standalone Chromium itself is not
+            officially tested with the App Sandbox enabled, and even if work is done to bypass
+            the App Store's restrictions, that would not guarantee correct behavior of the library.
+
     \endlist
 
     \section1 macOS Airplay Support on MacBooks with Dual GPUs
@@ -161,4 +162,24 @@
     set to 1 or alternatively the \c{--no-sandbox} command line argument can be passed to the user
     application executable.
 
+    \section1 Accessibility and Performance
+
+    Qt WebEngine enables accessibility support for web pages when the following conditions
+    are met:
+
+    \list
+        \li Qt Core is configured and built with accessibility support enabled.
+        \li The QPA plugin is notified by the operating system that accessibility should be
+            activated. This happens for example when using a screen reader application on Windows
+            or VoiceOver on \macos.
+    \endlist
+
+    Due to some limitations, the Linux QPA plugin almost always reports that accessibility should
+    be activated. On big HTML pages, this can cause a significant slowdown in rendering speed.
+
+    Because of that, from Qt 5.9 onwards, Qt WebEngine accessibility support is disabled by default
+    on Linux.
+    It can be re-enabled by setting the \c QTWEBENGINE_ENABLE_LINUX_ACCESSIBILITY environment
+    variable to a non-empty value.
+
 */