From f73704b4c5ddcf3122ccd25b9e6684cf0ab8bc55 Mon Sep 17 00:00:00 2001
From: Tarja Sundqvist <tarja.sundqvist@qt.io>
Date: Tue, 12 Mar 2019 10:58:35 +0200
Subject: Fix documentation build warning

Some build warnings fixed. The documentation was built with Qt 5.9.

Change-Id: I8f988c1267a6a6ed925cfac1f0cd40547ffc8160
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Teemu Holappa <teemu.holappa@qt.io>
---
 src/networksettings/qnetworksettings.cpp           | 36 ++++++++++++++++++++++
 .../qnetworksettingsinterfacemodel.cpp             |  6 ++++
 2 files changed, 42 insertions(+)

(limited to 'src/networksettings')

diff --git a/src/networksettings/qnetworksettings.cpp b/src/networksettings/qnetworksettings.cpp
index 49f210e..e4ddbad 100644
--- a/src/networksettings/qnetworksettings.cpp
+++ b/src/networksettings/qnetworksettings.cpp
@@ -464,6 +464,14 @@ void QNetworkSettingsIPv6::setPrefixLength(const int& prefixLength) {
     \sa QNetworkSettingsAddressModel
 */
 
+/*!
+    \property QNetworkSettingsProxy::servers
+    \readonly
+    \brief The model containing the proxy exclusion list.
+
+    This property holds the list of proxy server names.
+*/
+
 /*!
     Creates a new proxy configuration with the parent \a parent.
 */
@@ -486,6 +494,13 @@ QAbstractItemModel* QNetworkSettingsProxy::servers(void) {
     return &m_servers;
 }
 
+/*!
+    Sets the proxy server list.
+    \a servers lists the server names.
+
+    The QNetworkSettingsProxy::serversChanged signal is emitted when the server list
+    is set.
+*/
 void QNetworkSettingsProxy::setServers(const QStringList& servers) {
     m_servers.setStringList(servers);
     emit serversChanged();
@@ -503,6 +518,13 @@ QStringList QNetworkSettingsProxy::excludes() const {
     return m_excludes.stringList();
 }
 
+/*!
+    Sets the proxy exclusion list.
+    \a excludes lists the addresses on the exclustion list.
+
+    The QNetworkSettingsProxy::excludesChanged signal is emitted when the proxy
+    exclusion list is set.
+*/
 void QNetworkSettingsProxy::setExcludes(const QStringList& excludes) {
     m_excludes.setStringList(excludes);
     emit excludesChanged();
@@ -555,6 +577,11 @@ void QNetworkSettingsProxy::setMethod(const MethodType& method) {
     \brief Holds whether the Wifi access point is out of range.
 */
 
+/*!
+    \fn void QNetworkSettingsWireless::passwordChanged()
+
+    This signal is sent when the password has changed.
+*/
 
 /*!
     Creates a new Wifi network configuration with the parent \a parent.
@@ -580,6 +607,12 @@ bool QNetworkSettingsWireless::hidden() const {
     return m_hidden;
 }
 
+/*!
+    Sets \a hidden status.
+
+    The QNetworkSettingsWireless::hiddenChanged signal is emitted when the
+    hidden status is changed.
+*/
 void QNetworkSettingsWireless::setHidden(const bool hidden) {
     m_hidden = hidden;
     emit hiddenChanged();
@@ -594,6 +627,9 @@ void QNetworkSettingsWireless::setSignalStrength(const int signalStrength) {
     emit signalStrengthChanged();
 }
 
+/*!
+    Sets \a security flags.
+*/
 void QNetworkSettingsWireless::setSecurity(const SecurityFlags security) {
     if (security == None) {
         m_securityFlags = None;
diff --git a/src/networksettings/qnetworksettingsinterfacemodel.cpp b/src/networksettings/qnetworksettingsinterfacemodel.cpp
index d35aaf2..045d3ff 100644
--- a/src/networksettings/qnetworksettingsinterfacemodel.cpp
+++ b/src/networksettings/qnetworksettingsinterfacemodel.cpp
@@ -159,6 +159,9 @@ void QNetworkSettingsInterfaceModel::remove(int row)
     endRemoveRows();
 }
 
+/*!
+    Returns whether the interface with the \a name was removed successfully.
+*/
 bool QNetworkSettingsInterfaceModel::removeInterface(const QString &name)
 {
     bool ret = false;
@@ -172,6 +175,9 @@ bool QNetworkSettingsInterfaceModel::removeInterface(const QString &name)
     return ret;
 }
 
+/*!
+    Notifies that the \a row has been updated.
+*/
 void QNetworkSettingsInterfaceModel::updated(int row)
 {
     dataChanged(createIndex(row, 0), createIndex(row, 0));
-- 
cgit v1.2.3