diff --git a/src/core/api/qwebengineurlschemehandler.cpp b/src/core/api/qwebengineurlschemehandler.cpp
index b2994847bc38024f5d237b33de3558a308413881..8b3327805c263eecbfed93d2b0d293762fb7bacb 100644
--- a/src/core/api/qwebengineurlschemehandler.cpp
+++ b/src/core/api/qwebengineurlschemehandler.cpp
@@ -43,16 +43,22 @@ QT_BEGIN_NAMESPACE
 
 /*!
     \class QWebEngineUrlSchemeHandler
-    \brief The QWebEngineUrlSchemeHandler base class for handling custom URL schemes.
+    \brief The QWebEngineUrlSchemeHandler is a base class for handling custom URL schemes.
     \since 5.6
 
-    To implement a custom URL scheme for QtWebEngine you must write a class derived from this class,
+    To implement a custom URL scheme for QtWebEngine, you must write a class derived from this class,
     and reimplement requestStarted().
 
     \inmodule QtWebEngineCore
 
 */
 
+/*!
+    \fn QWebEngineUrlSchemeHandler::destroyed(QWebEngineUrlSchemeHandler*)
+
+    This signal is emitted when a custom URL scheme handler is deleted.
+*/
+
 QWebEngineUrlSchemeHandlerPrivate::QWebEngineUrlSchemeHandlerPrivate(const QByteArray &scheme)
     : m_scheme(scheme)
 {
@@ -70,6 +76,9 @@ QWebEngineUrlSchemeHandler::QWebEngineUrlSchemeHandler(const QByteArray &scheme,
 {
 }
 
+/*!
+    Deletes a custom URL scheme handler.
+*/
 QWebEngineUrlSchemeHandler::~QWebEngineUrlSchemeHandler()
 {
     Q_EMIT destroyed(this);