Improve cross-links between QtWebEngine classes in docs

Change-Id: Iae853d4d3ab73306f90d93b62a419d1d440a3259
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Kai Koehne <kai.koehne@qt.io>

src/core/api/qwebengineurlrequestinfo.cpp

@@ -96,6 +96,9 @@ ASSERT_ENUMS_MATCH(QtWebEngineCore::WebContentsAdapterClient::OtherNavigation, Q
     interceptor on the profile enables intercepting, blocking, and modifying URL requests
     before they reach the networking stack of Chromium.
 
+    You can install the interceptor on a profile via QWebEngineProfile::setRequestInterceptor()
+    or QQuickWebEngineProfile::setRequestInterceptor().
+
     \sa interceptRequest(), QWebEngineUrlRequestInfo
 */
 
@@ -108,14 +111,12 @@ ASSERT_ENUMS_MATCH(QtWebEngineCore::WebContentsAdapterClient::OtherNavigation, Q
 /*!
     \fn void QWebEngineUrlRequestInterceptor::interceptRequest(QWebEngineUrlRequestInfo &info)
 
-    Reimplementing this virtual function and setting the interceptor on a profile makes
-    it possible to intercept URL requests. This function is executed on the IO thread,
-    and therefore running long tasks here will block networking.
+    Reimplementing this virtual function makes it possible to intercept URL
+    requests. This function is executed on the IO thread, and therefore running
+    long tasks here will block networking.
 
     \a info contains the information about the URL request and will track internally
     whether its members have been altered.
-
-    \sa QWebEngineProfile::setRequestInterceptor()
 */
 
 

src/core/api/qwebengineurlschemehandler.cpp

@@ -49,7 +49,8 @@ QT_BEGIN_NAMESPACE
     \since 5.6
 
     To implement a custom URL scheme for QtWebEngine, you must write a class derived from this class,
-    and reimplement requestStarted().
+    and reimplement requestStarted(). Then install it via QWebEngineProfile::installUrlSchemeHandler()
+    or QQuickWebEngineProfile::installUrlSchemeHandler().
 
     \inmodule QtWebEngineCore
 

src/webenginewidgets/api/qwebenginecertificateerror.cpp

@@ -47,7 +47,8 @@ QT_BEGIN_NAMESPACE
     \since 5.4
     \inmodule QtWebEngineWidgets
 
-    Provides information about a certificate error.
+    Provides information about a certificate error. This class is used as a parameter of
+    QWebEnginePage::certificateError().
 */
 
 class QWebEngineCertificateErrorPrivate {