3 files changed, 70 insertions, 1 deletions
diff --git a/src/webenginewidgets/api/qwebenginefullscreenrequest.cpp b/src/webenginewidgets/api/qwebenginefullscreenrequest.cpp
index 57e8e31e7..bcf2d5d22 100644
--- a/src/webenginewidgets/api/qwebenginefullscreenrequest.cpp
+++ b/src/webenginewidgets/api/qwebenginefullscreenrequest.cpp
@@ -42,6 +42,64 @@
 
 QT_BEGIN_NAMESPACE
 
+/*!
+    \class QWebEngineFullScreenRequest
+    \brief The QWebEngineFullScreenRequest class enables accepting or rejecting
+     requests for entering and exiting the fullscreen mode.
+
+    \since 5.6
+
+    \inmodule QtWebEngineWidgets
+
+    To allow elements such as videos to be shown in the fullscreen mode,
+    applications must set QWebEngineSettings::FullScreenSupportEnabled and
+    connect to QWebEnginePage::fullScreenRequested, which takes a
+    QWebEngineFullScreenRequest instance as an argument.
+
+    If an element of a web page requests to be shown in the fullscreen mode,
+    QWebEnginePage::fullScreenRequested will be emitted with an
+    QWebEngineFullScreenRequest instance as an argument where toggleOn() returns
+    \c true. The signal handler needs to then either call accept() or reject().
+
+    If the request to enter the fullscreen mode is accepted, the element
+    requesting fullscreen mode will fill the viewport, but it is up to the
+    application to make the view fullscreen or to move the page to a view that
+    is in the fullscreen mode.
+
+    Likewise, a QWebEnginePage::fullScreenRequested will be emitted when
+    the user wants to leave the full screen mode (that is, through the
+    QWebEnginePage::ExitFullScreen context menu action). In this case,
+    toggleOn() will return \c false, and the signal handler again needs to
+    accept() or reject() the request. If it is accepted, the applicaton needs to
+    make sure that the global window state is restored.
+*/
+
+/*!
+    \property QWebEngineFullScreenRequest::toggleOn
+    \brief Whether the web page has issued a request to enter fullscreen mode.
+*/
+
+/*!
+    \property QWebEngineFullScreenRequest::origin
+    \brief The URL to be opened in the fullscreen mode.
+*/
+
+/*!
+    \fn QWebEngineFullScreenRequest::toggleOn() const
+    Returns \c true if the web page has issued a request to enter the fullscreen
+    mode, otherwise returns \c false.
+*/
+
+/*!
+    \fn QWebEngineFullScreenRequest::origin() const
+    Returns the URL to be opened in the fullscreen mode.
+*/
+
+/*!
+    Creates a request for opening the \a page from the URL specified by
+    \a origin in the fullscreen mode if \a fullscreen is \c true.
+*/
+
 QWebEngineFullScreenRequest::QWebEngineFullScreenRequest(QWebEnginePage *page, const QUrl &origin, bool fullscreen)
     : m_page(page)
     , m_origin(origin)
@@ -49,6 +107,9 @@ QWebEngineFullScreenRequest::QWebEngineFullScreenRequest(QWebEnginePage *page, c
 {
 }
 
+/*!
+    Rejects a request to enter or exit the fullscreen mode.
+*/
 void QWebEngineFullScreenRequest::reject()
 {
     if (!m_page) {
@@ -59,6 +120,9 @@ void QWebEngineFullScreenRequest::reject()
     m_page->d_func()->setFullScreenMode(!m_toggleOn);
 }
 
+/*!
+    Accepts the request to enter or exit the fullscreen mode.
+*/
 void QWebEngineFullScreenRequest::accept()
 {
     if (!m_page) {
diff --git a/src/webenginewidgets/api/qwebengineprofile.cpp b/src/webenginewidgets/api/qwebengineprofile.cpp
index 22495ee2e..22d4d088f 100644
--- a/src/webenginewidgets/api/qwebengineprofile.cpp
+++ b/src/webenginewidgets/api/qwebengineprofile.cpp
@@ -470,7 +470,9 @@ void QWebEngineProfile::setHttpCacheMaximumSize(int maxSize)
 }
 
 /*!
-    Returns the cookie store singleton, if one has been set.
+    Returns the cookie store for this profile.
+
+    \since 5.6
 */
 
 QWebEngineCookieStore* QWebEngineProfile::cookieStore()
@@ -485,6 +487,7 @@ QWebEngineCookieStore* QWebEngineProfile::cookieStore()
 
     The profile does not take ownership of the pointer.
 
+    \since 5.6
     \sa QWebEngineUrlRequestInfo
 */
 
diff --git a/src/webenginewidgets/api/qwebenginescript.cpp b/src/webenginewidgets/api/qwebenginescript.cpp
index 97760c10c..73dd5075e 100644
--- a/src/webenginewidgets/api/qwebenginescript.cpp
+++ b/src/webenginewidgets/api/qwebenginescript.cpp
@@ -61,6 +61,8 @@ using QtWebEngineCore::UserScript;
     not accessible from a different one. ScriptWorldId provides some predefined IDs for this
     purpose.
 
+    \note Chromium extensions, such as \c @include, \c @match, and \c @exclude, are not supported.
+
     Use QWebEnginePage::scripts() and QWebEngineProfile::scripts() to access
     the collection of scripts associated with a single page or a
     number of pages sharing the same profile.