Doc: Fix documentation warnings for Qt Network

The Clang compiler used in QDoc complained about the documentation-
specific overload of QAbstractSocket::bind():

  error: incomplete type 'QHostAddress' named in nested name specifier

Also, fix an attempted snippet inclusion to use the \include command,
and fix the comment tag spacing and indentation.

Pick-to: 6.2
Fixes: QTBUG-96293
Change-Id: Ie4d78933fa7ac0aaf7f3bcc6487e7fd823db5123
Reviewed-by: Mårten Nordheim <[email protected]>
Reviewed-by: Venugopal Shivashankar <[email protected]>

2 files changed, 7 insertions, 4 deletions

diff --git a/src/network/access/qnetworkaccessbackend.cpp b/src/network/access/qnetworkaccessbackend.cpp
index acac03220af..b544e8436b5 100644
--- a/src/network/access/qnetworkaccessbackend.cpp
+++ b/src/network/access/qnetworkaccessbackend.cpp
@@ -133,14 +133,14 @@ QStringList QNetworkAccessManagerPrivate::backendSupportedSchemes() const
     \since 6.0
     \internal
 
-    //![semi-private-notice]
+//! [semi-private-notice]
     The class is considered semi-private and as such requires linking
     to "NetworkPrivate" to access the header. Furthermore it means
     the class is not under the same binary compatibility restrictions
     as the rest of Qt. While we still try to avoid breakage it may
     still occur. The class is primarily meant to be used by plugins
     which would be recompiled every time Qt is updated.
-    //![semi-private-notice]
+//! [semi-private-notice]
 
     This class acts as the primary interface to the plugin and must
     be derived from. It deals with both querying supported schemes
@@ -177,7 +177,7 @@ QStringList QNetworkAccessManagerPrivate::backendSupportedSchemes() const
     \since 6.0
     \internal
 
-    \snippet qnetworkaccessbackend.cpp semi-private-notice
+    \include access/qnetworkaccessbackend.cpp semi-private-notice
 
     This class can be derived from to add support for further schemes
     in QNetworkAccessManager.
diff --git a/src/network/socket/qabstractsocket.h b/src/network/socket/qabstractsocket.h
index 96b86f63f70..03baa879aad 100644
--- a/src/network/socket/qabstractsocket.h
+++ b/src/network/socket/qabstractsocket.h
@@ -44,6 +44,9 @@
 #if QT_VERSION >= QT_VERSION_CHECK(7, 0, 0)
 #include <QtNetwork/qabstractsocket.h>
 #endif
+#ifdef Q_CLANG_QDOC
+#include <QtNetwork/qhostaddress.h>
+#endif
 #include <QtCore/qiodevice.h>
 #include <QtCore/qobject.h>
 #ifndef QT_NO_DEBUG_STREAM
@@ -166,7 +169,7 @@ public:
     bool bind(QHostAddress::SpecialAddress addr, quint16 port = 0, BindMode mode = DefaultForPlatform)
     { return bind(QHostAddress(addr), port, mode); }
     bool bind(quint16 port = 0, BindMode mode = DefaultForPlatform)
-    { retrurn bind(QHostAddress::Any, port, mode); }
+    { return bind(QHostAddress::Any, port, mode); }
 #else
     bool bind(quint16 port = 0, BindMode mode = DefaultForPlatform);
 #endif