From 0d4fe94a7ace3b0253e8acaeaa2d449314cfd103 Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@qt.io>
Date: Tue, 24 May 2016 16:32:59 +0200
Subject: Doc: Describe new features in Qt WebEngine 5.7.0

Change-Id: I409dee8a8116a374ee4587f0237a62c38dc51b0c
Reviewed-by: Kai Koehne <kai.koehne@qt.io>
Reviewed-by: Allan Sandfeld Jensen <allan.jensen@qt.io>
---
 src/webengine/doc/src/external-resources.qdoc   | 40 ++++++++++++++++++++++
 src/webengine/doc/src/qtwebengine-features.qdoc | 44 +++++++++++++++++++++++++
 2 files changed, 84 insertions(+)

diff --git a/src/webengine/doc/src/external-resources.qdoc b/src/webengine/doc/src/external-resources.qdoc
index c07df19b2..c4cfe24af 100644
--- a/src/webengine/doc/src/external-resources.qdoc
+++ b/src/webengine/doc/src/external-resources.qdoc
@@ -50,6 +50,46 @@
     \title OpenH264 Project Homepage
 */
 
+/*!
+    \externalpage http://html5demos.com/drag
+    \title HTML5 Demos - Drag and Drop
+*/
+
+/*!
+    \externalpage http://html5demos.com/drag-anything
+    \title HTML5 Demos - Simple Drag and Drop
+*/
+
+/*!
+    \externalpage http://html5demos.com/dnd-upload
+    \title HTML5 Demos - Drag and Drop, Automatic Upload
+*/
+
+/*!
+    \externalpage http://html5demos.com/file-api
+    \title HTML5 Demos - File API
+*/
+
+/*!
+    \externalpage http://www.widevine.com/wv_drm.html
+    \title Widevine DRM
+*/
+
+/*!
+    \externalpage http://demo.castlabs.com/
+    \title castLabs
+*/
+
+/*!
+    \externalpage http://ssdemo04.swankmp.net/
+    \title Swank Motion Pictures, Inc.
+*/
+
+/*!
+    \externalpage https://shaka-player-demo.appspot.com/demo/
+    \title Shaka Player
+*/
+
 /*
     This prevents autolinking of each occurrence of 'WebEngine'
     To link to the WebEngine QML type, use explicit linking:
diff --git a/src/webengine/doc/src/qtwebengine-features.qdoc b/src/webengine/doc/src/qtwebengine-features.qdoc
index 2c39e5922..f55eab23b 100644
--- a/src/webengine/doc/src/qtwebengine-features.qdoc
+++ b/src/webengine/doc/src/qtwebengine-features.qdoc
@@ -36,9 +36,12 @@
     \list
         \li \l{Audio and Video Codecs}
         \li \l{Chromium DevTools}
+        \li \l{Drag and Drop}
         \li \l{Fullscreen}
+        \li \l{HTML5 DRM}
         \li \l{HTML5 Geolocation}
         \li \l{Pepper Plugin API}
+        \li \l{Print to PDF}
         \li \l{WebRTC}
     \endlist
 
@@ -76,6 +79,21 @@
 
     For more information, see \l {Qt WebEngine Debugging and Profiling}.
 
+    \section1 Drag and Drop
+
+    Qt WebEngine supports HTML5 drag and drop.
+
+    This feature can be tested by opening an HTML5 drag and drop demo, such as
+    \l{HTML5 Demos - Drag and Drop}, \l{HTML5 Demos - Simple Drag and Drop}, or
+    \l{HTML5 Demos - Drag and Drop, Automatic Upload}, in \l{WebEngine Demo
+    Browser Example}{Demo Browser} or \l{WebEngine Quick Nano Browser}
+    {Nano Browser}.
+
+    Dragging files into the browser is not actually part of HTML5, but it is
+    supported. It can be tested by opening \l{HTML5 Demos - File API}.
+
+    Support for this feature was added in Qt 5.7.0.
+
     \section1 Fullscreen
 
     Qt WebEngine supports viewing web content in fullscreen mode. For more
@@ -92,6 +110,21 @@
 
     Support for this feature was added in Qt 5.6.0.
 
+    \section1 HTML5 DRM
+
+    Qt WebEngine supports viewing DRM protected videos if the \l{Widevine DRM}
+    plugin has been installed.
+
+    The video format most commonly used by DRM services, H.264, requires
+    proprietary audio and video codecs. For more information about enabling the
+    codecs, see \l{Audio and Video Codecs}.
+
+    This feature can be tested by playing a video in \l{WebEngine Demo Browser
+    Example}{Demo Browser} or \l{WebEngine Quick Nano Browser}{Nano Browser}
+    from \l{castLabs}, \l{Swank Motion Pictures, Inc.}, or \l{Shaka Player}.
+
+    Support for this feature was added in Qt 5.7.0.
+
     \section1 HTML5 Geolocation
 
     Qt WebEngine supports JavaScript Geolocation API with \l {Qt Location} as a
@@ -176,6 +209,17 @@
     feature, the \c https://helpx.adobe.com/flash-player.html page can be opened
     in the browser.
 
+    \section1 Print to PDF
+
+    Qt WebEngine supports printing a web page to a PDF file. For more
+    information, see QWebEnginePage::printToPdf() and
+    \l{WebEngineView::printToPdf}{WebEngineView.printToPdf}.
+
+    This feature can be tested in \l{WebEngine Demo Browser Example}
+    {Demo Browser} by selecting \uicontrol File > \uicontrol {Print to PDF}.
+
+    Support for this feature was added in Qt 5.7.0.
+
     \section1 WebRTC
 
     WebRTC provides browsers with Real-Time Communications (RTC) capabilities
-- 
cgit v1.2.3