[Pkg-owncloud-commits] [owncloud-client] 218/498: Use doxygen style everywhere
Sandro Knauß
hefee-guest at moszumanska.debian.org
Tue Aug 11 14:48:52 UTC 2015
This is an automated email from the git hooks/post-receive script.
hefee-guest pushed a commit to branch master
in repository owncloud-client.
commit 66e8aaeabc971dc7b8a3c57d37e1e0b408cdccc7
Author: Daniel Molkentin <danimo at owncloud.com>
Date: Mon Jun 29 18:56:09 2015 +0200
Use doxygen style everywhere
---
src/cmd/cmd.h | 6 +--
src/cmd/netrcparser.h | 6 +--
src/cmd/simplesslerrorhandler.h | 6 +--
src/gui/accountmanager.h | 6 +--
src/gui/accountmigrator.h | 6 +--
src/gui/accountsettings.h | 6 +--
src/gui/accountstate.h | 6 +--
src/gui/addcertificatedialog.h | 6 +--
src/gui/application.h | 6 +--
src/gui/authenticationdialog.h | 6 +--
src/gui/cocoainitializer.h | 6 +--
src/gui/creds/credentialsfactory.h | 6 +--
src/gui/creds/httpcredentialsgui.h | 6 +--
src/gui/creds/shibboleth/shibbolethrefresher.h | 6 +--
src/gui/creds/shibboleth/shibbolethuserjob.h | 6 +--
src/gui/creds/shibboleth/shibbolethwebview.h | 6 +--
src/gui/creds/shibbolethcredentials.h | 6 +--
src/gui/folder.h | 12 +++---
src/gui/folderman.h | 6 +--
src/gui/folderstatusdelegate.h | 6 +--
src/gui/folderstatusmodel.h | 6 +--
src/gui/folderwatcher.h | 6 +--
src/gui/folderwatcher_linux.h | 6 +--
src/gui/folderwatcher_mac.h | 6 +--
src/gui/folderwatcher_qt.h | 6 +--
src/gui/folderwatcher_win.h | 12 +++---
src/gui/folderwizard.h | 30 +++++++--------
src/gui/generalsettings.h | 6 +--
src/gui/ignorelisteditor.h | 6 +--
src/gui/logbrowser.h | 12 +++---
src/gui/networksettings.h | 6 +--
src/gui/openfilemanager.h | 6 +--
src/gui/owncloudgui.h | 6 +--
src/gui/owncloudsetupwizard.h | 12 +++---
src/gui/protocolwidget.h | 6 +--
src/gui/quotainfo.h | 6 +--
src/gui/selectivesyncdialog.h | 12 +++---
src/gui/settingsdialog.h | 6 +--
src/gui/settingsdialogmac.h | 6 +--
src/gui/sharedialog.h | 12 +++---
src/gui/socketapi.h | 6 +--
src/gui/sslbutton.h | 6 +--
src/gui/sslerrordialog.h | 12 +++---
src/gui/syncrunfilelog.h | 6 +--
src/gui/systray.h | 6 +--
src/gui/updater/ocupdater.h | 16 ++++----
src/gui/wizard/abstractcredswizardpage.h | 6 +--
src/gui/wizard/owncloudadvancedsetuppage.h | 6 +--
src/gui/wizard/owncloudconnectionmethoddialog.h | 6 +--
src/gui/wizard/owncloudhttpcredspage.h | 4 +-
src/gui/wizard/owncloudsetuppage.h | 6 +--
src/gui/wizard/owncloudshibbolethcredspage.h | 6 +--
src/gui/wizard/owncloudwizard.h | 6 +--
src/gui/wizard/owncloudwizardresultpage.h | 6 +--
src/libsync/abstractnetworkjob.h | 4 +-
src/libsync/accessmanager.h | 6 +--
src/libsync/account.h | 14 +++----
src/libsync/bandwidthmanager.h | 6 +--
src/libsync/clientproxy.h | 6 +--
src/libsync/configfile.h | 6 +--
src/libsync/connectionvalidator.h | 2 +-
src/libsync/cookiejar.h | 6 +--
src/libsync/discoveryphase.h | 18 ++++-----
src/libsync/filesystem.h | 50 ++++++++++++-------------
src/libsync/logger.h | 6 +--
src/libsync/networkjobs.h | 34 ++++++++---------
src/libsync/owncloudpropagator.h | 24 ++++++------
src/libsync/owncloudtheme.h | 6 +--
src/libsync/ownsql.h | 12 +++---
src/libsync/progressdispatcher.h | 6 +--
src/libsync/propagatedownload.h | 12 +++---
src/libsync/propagateremotedelete.h | 12 +++---
src/libsync/propagateremotemkdir.h | 6 +--
src/libsync/propagateremotemove.h | 12 +++---
src/libsync/propagateupload.h | 24 ++++++------
src/libsync/propagator_legacy.h | 18 ++++-----
src/libsync/propagatorjobs.h | 18 ++++-----
src/libsync/syncengine.h | 6 +--
src/libsync/syncfileitem.h | 6 +--
src/libsync/syncfilestatus.h | 6 +--
src/libsync/syncjournaldb.h | 6 +--
src/libsync/syncjournalfilerecord.h | 6 +--
src/libsync/syncresult.h | 6 +--
src/libsync/theme.h | 6 +--
src/libsync/transmissionchecksumvalidator.h | 6 +--
85 files changed, 377 insertions(+), 377 deletions(-)
diff --git a/src/cmd/cmd.h b/src/cmd/cmd.h
index ef07f32..06ae2fa 100644
--- a/src/cmd/cmd.h
+++ b/src/cmd/cmd.h
@@ -18,9 +18,9 @@
#include <QObject>
-/*!
- * \brief Helper class for command line client
- * \ingroup cmd
+/**
+ * @brief Helper class for command line client
+ * @ingroup cmd
*/
class Cmd : public QObject {
Q_OBJECT
diff --git a/src/cmd/netrcparser.h b/src/cmd/netrcparser.h
index 6d67d8f..4140b06 100644
--- a/src/cmd/netrcparser.h
+++ b/src/cmd/netrcparser.h
@@ -20,9 +20,9 @@
namespace OCC {
-/*!
- * \brief Parser for netrc files
- * \ingroup cmd
+/**
+ * @brief Parser for netrc files
+ * @ingroup cmd
*/
class NetrcParser
{
diff --git a/src/cmd/simplesslerrorhandler.h b/src/cmd/simplesslerrorhandler.h
index 69789a3..69d2234 100644
--- a/src/cmd/simplesslerrorhandler.h
+++ b/src/cmd/simplesslerrorhandler.h
@@ -20,9 +20,9 @@ class QSslCertificate;
namespace OCC {
-/*!
- * \brief The SimpleSslErrorHandler class
- * \ingroup cmd
+/**
+ * @brief The SimpleSslErrorHandler class
+ * @ingroup cmd
*/
class SimpleSslErrorHandler : public OCC::AbstractSslErrorHandler {
public:
diff --git a/src/gui/accountmanager.h b/src/gui/accountmanager.h
index 0d10d20..9af0dbf 100644
--- a/src/gui/accountmanager.h
+++ b/src/gui/accountmanager.h
@@ -20,9 +20,9 @@ namespace OCC {
typedef QSharedPointer<AccountState> AccountStatePtr;
-/*!
- \brief The AccountManager class
- \ingroup gui
+/**
+ @brief The AccountManager class
+ @ingroup gui
*/
class AccountManager : public QObject {
Q_OBJECT
diff --git a/src/gui/accountmigrator.h b/src/gui/accountmigrator.h
index 5b0d6f4..7a023c7 100644
--- a/src/gui/accountmigrator.h
+++ b/src/gui/accountmigrator.h
@@ -18,9 +18,9 @@
namespace OCC {
-/*!
- * \brief The AccountSettings class
- * \ingroup gui
+/**
+ * @brief The AccountSettings class
+ * @ingroup gui
*/
class AccountMigrator {
diff --git a/src/gui/accountsettings.h b/src/gui/accountsettings.h
index 0ce4e64..c5d7a23 100644
--- a/src/gui/accountsettings.h
+++ b/src/gui/accountsettings.h
@@ -41,9 +41,9 @@ class Account;
class AccountState;
class FolderStatusModel;
-/*!
- * \brief The AccountSettings class
- * \ingroup gui
+/**
+ * @brief The AccountSettings class
+ * @ingroup gui
*/
class AccountSettings : public QWidget
{
diff --git a/src/gui/accountstate.h b/src/gui/accountstate.h
index 7efc905..b778dda 100644
--- a/src/gui/accountstate.h
+++ b/src/gui/accountstate.h
@@ -29,9 +29,9 @@ class AccountState;
class Account;
class AbstractCredentials;
-/*!
- * \brief Extra info about an ownCloud server account.
- * \ingroup gui
+/**
+ * @brief Extra info about an ownCloud server account.
+ * @ingroup gui
*/
class AccountState : public QObject {
Q_OBJECT
diff --git a/src/gui/addcertificatedialog.h b/src/gui/addcertificatedialog.h
index 3c6c5dc..26baf6f 100644
--- a/src/gui/addcertificatedialog.h
+++ b/src/gui/addcertificatedialog.h
@@ -24,9 +24,9 @@ namespace Ui {
class AddCertificateDialog;
}
-/*!
- * \brief The AddCertificateDialog class
- * \ingroup gui
+/**
+ * @brief The AddCertificateDialog class
+ * @ingroup gui
*/
class AddCertificateDialog : public QDialog
{
diff --git a/src/gui/application.h b/src/gui/application.h
index 676ab53..56fcc12 100644
--- a/src/gui/application.h
+++ b/src/gui/application.h
@@ -43,9 +43,9 @@ class Theme;
class Folder;
class SslErrorDialog;
-/*!
- * \brief The Application class
- * \ingroup gui
+/**
+ * @brief The Application class
+ * @ingroup gui
*/
class Application : public SharedTools::QtSingleApplication
{
diff --git a/src/gui/authenticationdialog.h b/src/gui/authenticationdialog.h
index cfa1f3f..f3b9438 100644
--- a/src/gui/authenticationdialog.h
+++ b/src/gui/authenticationdialog.h
@@ -20,9 +20,9 @@ class QLineEdit;
namespace OCC {
-/*!
- * \brief Authenticate a user for a specific credential given his credentials
- * \ingroup gui
+/**
+ * @brief Authenticate a user for a specific credential given his credentials
+ * @ingroup gui
*/
class AuthenticationDialog : public QDialog {
Q_OBJECT
diff --git a/src/gui/cocoainitializer.h b/src/gui/cocoainitializer.h
index a55c588..b5082a6 100644
--- a/src/gui/cocoainitializer.h
+++ b/src/gui/cocoainitializer.h
@@ -14,9 +14,9 @@
namespace OCC {
namespace Mac {
-/*!
- * \brief CocoaInitializer provides an AutoRelease Pool via RIIA for use in main()
- * \ingroup gui
+/**
+ * @brief CocoaInitializer provides an AutoRelease Pool via RIIA for use in main()
+ * @ingroup gui
*/
class CocoaInitializer {
public:
diff --git a/src/gui/creds/credentialsfactory.h b/src/gui/creds/credentialsfactory.h
index 6763c62..95c8dd9 100644
--- a/src/gui/creds/credentialsfactory.h
+++ b/src/gui/creds/credentialsfactory.h
@@ -23,9 +23,9 @@ namespace OCC
class AbstractCredentials;
-/*!
- * \brief The HttpCredentialsGui namespace
- * \ingroup gui
+/**
+ * @brief The HttpCredentialsGui namespace
+ * @ingroup gui
*/
namespace CredentialsFactory
{
diff --git a/src/gui/creds/httpcredentialsgui.h b/src/gui/creds/httpcredentialsgui.h
index 4441c2c..f53210d 100644
--- a/src/gui/creds/httpcredentialsgui.h
+++ b/src/gui/creds/httpcredentialsgui.h
@@ -19,9 +19,9 @@
namespace OCC
{
-/*!
- * \brief The HttpCredentialsGui class
- * \ingroup gui
+/**
+ * @brief The HttpCredentialsGui class
+ * @ingroup gui
*/
class HttpCredentialsGui : public HttpCredentials {
Q_OBJECT
diff --git a/src/gui/creds/shibboleth/shibbolethrefresher.h b/src/gui/creds/shibboleth/shibbolethrefresher.h
index 9b62f18..2e5a7ae 100644
--- a/src/gui/creds/shibboleth/shibbolethrefresher.h
+++ b/src/gui/creds/shibboleth/shibbolethrefresher.h
@@ -26,9 +26,9 @@ namespace OCC
class Account;
class ShibbolethCredentials;
-/*!
- * \brief The ShibbolethRefresher class
- * \ingroup gui
+/**
+ * @brief The ShibbolethRefresher class
+ * @ingroup gui
*/
class ShibbolethRefresher : public QObject
{
diff --git a/src/gui/creds/shibboleth/shibbolethuserjob.h b/src/gui/creds/shibboleth/shibbolethuserjob.h
index a918ccb..57ee34c 100644
--- a/src/gui/creds/shibboleth/shibbolethuserjob.h
+++ b/src/gui/creds/shibboleth/shibbolethuserjob.h
@@ -19,9 +19,9 @@
namespace OCC
{
-/*!
- * \brief Fetch the user name of the shibboleth connection
- * \ingroup gui
+/**
+ * @brief Fetch the user name of the shibboleth connection
+ * @ingroup gui
*/
class ShibbolethUserJob : public JsonApiJob {
Q_OBJECT
diff --git a/src/gui/creds/shibboleth/shibbolethwebview.h b/src/gui/creds/shibboleth/shibbolethwebview.h
index 1e656cf..04f8372 100644
--- a/src/gui/creds/shibboleth/shibbolethwebview.h
+++ b/src/gui/creds/shibboleth/shibbolethwebview.h
@@ -28,9 +28,9 @@ namespace OCC
class ShibbolethCookieJar;
-/*!
- * \brief The ShibbolethWebView class
- * \ingroup gui
+/**
+ * @brief The ShibbolethWebView class
+ * @ingroup gui
*/
class ShibbolethWebView : public QWebView
{
diff --git a/src/gui/creds/shibbolethcredentials.h b/src/gui/creds/shibbolethcredentials.h
index a2feae7..a4e2663 100644
--- a/src/gui/creds/shibbolethcredentials.h
+++ b/src/gui/creds/shibbolethcredentials.h
@@ -33,9 +33,9 @@ namespace OCC
class ShibbolethWebView;
-/*!
- * \brief The ShibbolethCredentials class
- * \ingroup gui
+/**
+ * @brief The ShibbolethCredentials class
+ * @ingroup gui
*/
class ShibbolethCredentials : public AbstractCredentials
{
diff --git a/src/gui/folder.h b/src/gui/folder.h
index bb9c852..2a79784 100644
--- a/src/gui/folder.h
+++ b/src/gui/folder.h
@@ -44,9 +44,9 @@ namespace OCC {
class SyncEngine;
class AccountState;
-/*!
- * \brief The FolderDefinition class
- * \ingroup gui
+/**
+ * @brief The FolderDefinition class
+ * @ingroup gui
*/
class FolderDefinition
{
@@ -72,9 +72,9 @@ public:
FolderDefinition* folder);
};
-/*!
- * \brief The Folder class
- * \ingroup gui
+/**
+ * @brief The Folder class
+ * @ingroup gui
*/
class Folder : public QObject
{
diff --git a/src/gui/folderman.h b/src/gui/folderman.h
index 61f633b..3862e08 100644
--- a/src/gui/folderman.h
+++ b/src/gui/folderman.h
@@ -33,9 +33,9 @@ class Application;
class SyncResult;
class SocketApi;
-/*!
- * \brief The FolderMan class
- * \ingroup gui
+/**
+ * @brief The FolderMan class
+ * @ingroup gui
*/
class FolderMan : public QObject
{
diff --git a/src/gui/folderstatusdelegate.h b/src/gui/folderstatusdelegate.h
index fd7237b..292d791 100644
--- a/src/gui/folderstatusdelegate.h
+++ b/src/gui/folderstatusdelegate.h
@@ -18,9 +18,9 @@
namespace OCC {
-/*!
- * \brief The FolderStatusDelegate class
- * \ingroup gui
+/**
+ * @brief The FolderStatusDelegate class
+ * @ingroup gui
*/
class FolderStatusDelegate : public QStyledItemDelegate
{
diff --git a/src/gui/folderstatusmodel.h b/src/gui/folderstatusmodel.h
index 1a1f724..6836849 100644
--- a/src/gui/folderstatusmodel.h
+++ b/src/gui/folderstatusmodel.h
@@ -26,9 +26,9 @@ namespace OCC {
class Folder;
class ProgressInfo;
-/*!
- * \brief The FolderStatusModel class
- * \ingroup gui
+/**
+ * @brief The FolderStatusModel class
+ * @ingroup gui
*/
class FolderStatusModel : public QAbstractItemModel
{
diff --git a/src/gui/folderwatcher.h b/src/gui/folderwatcher.h
index b5f2fbb..7a7a41d 100644
--- a/src/gui/folderwatcher.h
+++ b/src/gui/folderwatcher.h
@@ -31,8 +31,8 @@ namespace OCC {
class FolderWatcherPrivate;
-/*!
- * \brief Montiors a directory recursively for changes
+/**
+ * @brief Montiors a directory recursively for changes
*
* Folder Watcher monitors a directory and its sub directories
* for changes in the local file system. Changes are signalled
@@ -43,7 +43,7 @@ class FolderWatcherPrivate;
* dirs. That is the responsibility of the user of this class to
* call addPath() with the new dir.
*
- * \ingroup gui
+ * @ingroup gui
*/
class FolderWatcher : public QObject
diff --git a/src/gui/folderwatcher_linux.h b/src/gui/folderwatcher_linux.h
index f40e802..bc36133 100644
--- a/src/gui/folderwatcher_linux.h
+++ b/src/gui/folderwatcher_linux.h
@@ -25,9 +25,9 @@
namespace OCC
{
-/*!
- * \brief Linux (inotify) API implementation of FolderWatcher
- * \ingroup gui
+/**
+ * @brief Linux (inotify) API implementation of FolderWatcher
+ * @ingroup gui
*/
class FolderWatcherPrivate : public QObject
{
diff --git a/src/gui/folderwatcher_mac.h b/src/gui/folderwatcher_mac.h
index 7835758..e263ba1 100644
--- a/src/gui/folderwatcher_mac.h
+++ b/src/gui/folderwatcher_mac.h
@@ -23,9 +23,9 @@
namespace OCC
{
-/*!
- * \brief Mac OS X API implementation of FolderWatcher
- * \ingroup gui
+/**
+ * @brief Mac OS X API implementation of FolderWatcher
+ * @ingroup gui
*/
class FolderWatcherPrivate
{
diff --git a/src/gui/folderwatcher_qt.h b/src/gui/folderwatcher_qt.h
index e9b983f..f31c768 100644
--- a/src/gui/folderwatcher_qt.h
+++ b/src/gui/folderwatcher_qt.h
@@ -22,9 +22,9 @@ namespace OCC {
class FolderWatcher;
-/*!
- * \brief Qt API implementation of FolderWatcher
- * \ingroup gui
+/**
+ * @brief Qt API implementation of FolderWatcher
+ * @ingroup gui
*/
class FolderWatcherPrivate : public QObject {
Q_OBJECT
diff --git a/src/gui/folderwatcher_win.h b/src/gui/folderwatcher_win.h
index 19598f3..4a72be4 100644
--- a/src/gui/folderwatcher_win.h
+++ b/src/gui/folderwatcher_win.h
@@ -21,9 +21,9 @@ namespace OCC {
class FolderWatcher;
-/*!
- * \brief The WatcherThread class
- * \ingroup gui
+/**
+ * @brief The WatcherThread class
+ * @ingroup gui
*/
class WatcherThread : public QThread {
Q_OBJECT
@@ -46,9 +46,9 @@ private:
HANDLE _handle;
};
-/*!
- * \brief Windows implementation of FolderWatcher
- * \ingroup gui
+/**
+ * @brief Windows implementation of FolderWatcher
+ * @ingroup gui
*/
class FolderWatcherPrivate : public QObject {
Q_OBJECT
diff --git a/src/gui/folderwizard.h b/src/gui/folderwizard.h
index 24f4eb6..945a95f 100644
--- a/src/gui/folderwizard.h
+++ b/src/gui/folderwizard.h
@@ -31,9 +31,9 @@ class SelectiveSyncTreeView;
class ownCloudInfo;
-/*!
- * \brief The FormatWarningsWizardPage class
- * \ingroup gui
+/**
+ * @brief The FormatWarningsWizardPage class
+ * @ingroup gui
*/
class FormatWarningsWizardPage : public QWizardPage {
Q_OBJECT
@@ -41,9 +41,9 @@ protected:
QString formatWarnings(const QStringList &warnings) const;
};
-/*!
- * \brief Page to ask for the local source folder
- * \ingroup gui
+/**
+ * @brief Page to ask for the local source folder
+ * @ingroup gui
*/
class FolderWizardLocalPath : public FormatWarningsWizardPage
{
@@ -66,9 +66,9 @@ private:
};
-/*!
- * \brief page to ask for the target folder
- * \ingroup gui
+/**
+ * @brief page to ask for the target folder
+ * @ingroup gui
*/
class FolderWizardRemotePath : public FormatWarningsWizardPage
@@ -106,9 +106,9 @@ private:
QTimer _lscolTimer;
};
-/*!
- * \brief The FolderWizardSelectiveSync class
- * \ingroup gui
+/**
+ * @brief The FolderWizardSelectiveSync class
+ * @ingroup gui
*/
class FolderWizardSelectiveSync : public QWizardPage
{
@@ -127,9 +127,9 @@ private:
};
-/*!
- * \brief The FolderWizard class
- * \ingroup gui
+/**
+ * @brief The FolderWizard class
+ * @ingroup gui
*/
class FolderWizard : public QWizard
{
diff --git a/src/gui/generalsettings.h b/src/gui/generalsettings.h
index 5be59c0..ab21e9b 100644
--- a/src/gui/generalsettings.h
+++ b/src/gui/generalsettings.h
@@ -24,9 +24,9 @@ namespace Ui {
class GeneralSettings;
}
-/*!
- * \brief The GeneralSettings class
- * \ingroup gui
+/**
+ * @brief The GeneralSettings class
+ * @ingroup gui
*/
class GeneralSettings : public QWidget
{
diff --git a/src/gui/ignorelisteditor.h b/src/gui/ignorelisteditor.h
index aa573bb..57bb04a 100644
--- a/src/gui/ignorelisteditor.h
+++ b/src/gui/ignorelisteditor.h
@@ -24,9 +24,9 @@ namespace Ui {
class IgnoreListEditor;
}
-/*!
- * \brief The IgnoreListEditor class
- * \ingroup gui
+/**
+ * @brief The IgnoreListEditor class
+ * @ingroup gui
*/
class IgnoreListEditor : public QDialog
{
diff --git a/src/gui/logbrowser.h b/src/gui/logbrowser.h
index cb4bf87..719591a 100644
--- a/src/gui/logbrowser.h
+++ b/src/gui/logbrowser.h
@@ -28,9 +28,9 @@
namespace OCC {
-/*!
- * \brief The LogWidget class
- * \ingroup gui
+/**
+ * @brief The LogWidget class
+ * @ingroup gui
*/
class LogWidget : public QPlainTextEdit
{
@@ -42,9 +42,9 @@ signals:
};
-/*!
- * \brief The LogBrowser class
- * \ingroup gui
+/**
+ * @brief The LogBrowser class
+ * @ingroup gui
*/
class LogBrowser : public QDialog
{
diff --git a/src/gui/networksettings.h b/src/gui/networksettings.h
index 2f9dd33..2e18d35 100644
--- a/src/gui/networksettings.h
+++ b/src/gui/networksettings.h
@@ -23,9 +23,9 @@ namespace Ui {
class NetworkSettings;
}
-/*!
- * \brief The NetworkSettings class
- * \ingroup gui
+/**
+ * @brief The NetworkSettings class
+ * @ingroup gui
*/
class NetworkSettings : public QWidget
{
diff --git a/src/gui/openfilemanager.h b/src/gui/openfilemanager.h
index 5d8a33c..898b2f1 100644
--- a/src/gui/openfilemanager.h
+++ b/src/gui/openfilemanager.h
@@ -15,9 +15,9 @@
#include <QString>
namespace OCC {
-/*!
- * \brief Open the file manager with the specified file pre-selected
- * \ingroup gui
+/**
+ * @brief Open the file manager with the specified file pre-selected
+ * @ingroup gui
*/
void showInFileManager(const QString &localPath);
}
diff --git a/src/gui/owncloudgui.h b/src/gui/owncloudgui.h
index 1a2960b..d609bcd 100644
--- a/src/gui/owncloudgui.h
+++ b/src/gui/owncloudgui.h
@@ -33,9 +33,9 @@ class SettingsDialogMac;
class Application;
class LogBrowser;
-/*!
- * \brief The ownCloudGui class
- * \ingroup gui
+/**
+ * @brief The ownCloudGui class
+ * @ingroup gui
*/
class ownCloudGui : public QObject
{
diff --git a/src/gui/owncloudsetupwizard.h b/src/gui/owncloudsetupwizard.h
index 99829fa..e267ee0 100644
--- a/src/gui/owncloudsetupwizard.h
+++ b/src/gui/owncloudsetupwizard.h
@@ -33,9 +33,9 @@ class AccountState;
class OwncloudWizard;
-/*!
- * \brief The DetermineAuthTypeJob class
- * \ingroup gui
+/**
+ * @brief The DetermineAuthTypeJob class
+ * @ingroup gui
*/
class DetermineAuthTypeJob : public AbstractNetworkJob {
Q_OBJECT
@@ -50,9 +50,9 @@ private:
int _redirects;
};
-/*!
- * \brief The OwncloudSetupWizard class
- * \ingroup gui
+/**
+ * @brief The OwncloudSetupWizard class
+ * @ingroup gui
*/
class OwncloudSetupWizard : public QObject
{
diff --git a/src/gui/protocolwidget.h b/src/gui/protocolwidget.h
index e792527..1a688a1 100644
--- a/src/gui/protocolwidget.h
+++ b/src/gui/protocolwidget.h
@@ -32,9 +32,9 @@ namespace Ui {
}
class Application;
-/*!
- * \brief The ProtocolWidget class
- * \ingroup gui
+/**
+ * @brief The ProtocolWidget class
+ * @ingroup gui
*/
class ProtocolWidget : public QWidget
{
diff --git a/src/gui/quotainfo.h b/src/gui/quotainfo.h
index 286bfca..294ad6d 100644
--- a/src/gui/quotainfo.h
+++ b/src/gui/quotainfo.h
@@ -24,8 +24,8 @@ namespace OCC {
class AccountState;
class PropfindJob;
-/*!
- * \brief handles getting the quota to display in the UI
+/**
+ * @brief handles getting the quota to display in the UI
*
* It is typically owned by the AccountSetting page.
*
@@ -40,7 +40,7 @@ class PropfindJob;
*
* If the quota job is not finished within 30 seconds, it is cancelled and another one is started
*
- * \ingroup gui
+ * @ingroup gui
*/
class QuotaInfo : public QObject {
Q_OBJECT
diff --git a/src/gui/selectivesyncdialog.h b/src/gui/selectivesyncdialog.h
index a68b5c1..15702d8 100644
--- a/src/gui/selectivesyncdialog.h
+++ b/src/gui/selectivesyncdialog.h
@@ -25,9 +25,9 @@ namespace OCC {
class Folder;
-/*!
- * \brief The SelectiveSyncTreeView class
- * \ingroup gui
+/**
+ * @brief The SelectiveSyncTreeView class
+ * @ingroup gui
*/
class SelectiveSyncTreeView : public QTreeWidget {
Q_OBJECT
@@ -61,9 +61,9 @@ private:
QLabel *_loading;
};
-/*!
- * \brief The SelectiveSyncDialog class
- * \ingroup gui
+/**
+ * @brief The SelectiveSyncDialog class
+ * @ingroup gui
*/
class SelectiveSyncDialog : public QDialog {
Q_OBJECT
diff --git a/src/gui/settingsdialog.h b/src/gui/settingsdialog.h
index a4db715..54748a3 100644
--- a/src/gui/settingsdialog.h
+++ b/src/gui/settingsdialog.h
@@ -34,9 +34,9 @@ class Application;
class FolderMan;
class ownCloudGui;
-/*!
- * \brief The SettingsDialog class
- * \ingroup gui
+/**
+ * @brief The SettingsDialog class
+ * @ingroup gui
*/
class SettingsDialog : public QDialog
{
diff --git a/src/gui/settingsdialogmac.h b/src/gui/settingsdialogmac.h
index faa85f7..69c8ffc 100644
--- a/src/gui/settingsdialogmac.h
+++ b/src/gui/settingsdialogmac.h
@@ -31,9 +31,9 @@ class ownCloudGui;
class Folder;
class AccountState;
-/*!
- * \brief The SettingsDialogMac class
- * \ingroup gui
+/**
+ * @brief The SettingsDialogMac class
+ * @ingroup gui
*/
class SettingsDialogMac : public MacPreferencesWindow
{
diff --git a/src/gui/sharedialog.h b/src/gui/sharedialog.h
index 8a8a92f..c07d0c3 100644
--- a/src/gui/sharedialog.h
+++ b/src/gui/sharedialog.h
@@ -23,9 +23,9 @@
namespace OCC {
-/*!
- * \brief The OcsShareJob class
- * \ingroup gui
+/**
+ * @brief The OcsShareJob class
+ * @ingroup gui
*/
class OcsShareJob : public AbstractNetworkJob {
Q_OBJECT
@@ -57,9 +57,9 @@ class AbstractCredentials;
class QuotaInfo;
class SyncResult;
-/*!
- * \brief The ShareDialog class
- * \ingroup gui
+/**
+ * @brief The ShareDialog class
+ * @ingroup gui
*/
class ShareDialog : public QDialog
{
diff --git a/src/gui/socketapi.h b/src/gui/socketapi.h
index 7e284f7..511cfc0 100644
--- a/src/gui/socketapi.h
+++ b/src/gui/socketapi.h
@@ -40,9 +40,9 @@ namespace OCC {
class SyncFileStatus;
class Folder;
-/*!
- * \brief The SocketApi class
- * \ingroup gui
+/**
+ * @brief The SocketApi class
+ * @ingroup gui
*/
class SocketApi : public QObject
{
diff --git a/src/gui/sslbutton.h b/src/gui/sslbutton.h
index 191a0c0..b201805 100644
--- a/src/gui/sslbutton.h
+++ b/src/gui/sslbutton.h
@@ -26,9 +26,9 @@ namespace OCC {
class AccountState;
-/*!
- * \brief The SslButton class
- * \ingroup gui
+/**
+ * @brief The SslButton class
+ * @ingroup gui
*/
class SslButton : public QToolButton
{
diff --git a/src/gui/sslerrordialog.h b/src/gui/sslerrordialog.h
index 09badf2..e4de70a 100644
--- a/src/gui/sslerrordialog.h
+++ b/src/gui/sslerrordialog.h
@@ -31,18 +31,18 @@ namespace Ui {
class SslErrorDialog;
}
-/*!
- * \brief The SslDialogErrorHandler class
- * \ingroup gui
+/**
+ * @brief The SslDialogErrorHandler class
+ * @ingroup gui
*/
class SslDialogErrorHandler : public AbstractSslErrorHandler {
public:
bool handleErrors(QList<QSslError> errors, const QSslConfiguration &conf, QList<QSslCertificate> *certs, AccountPtr) Q_DECL_OVERRIDE;
};
-/*!
- * \brief The SslErrorDialog class
- * \ingroup gui
+/**
+ * @brief The SslErrorDialog class
+ * @ingroup gui
*/
class SslErrorDialog : public QDialog
{
diff --git a/src/gui/syncrunfilelog.h b/src/gui/syncrunfilelog.h
index cf79a6e..da0b4c2 100644
--- a/src/gui/syncrunfilelog.h
+++ b/src/gui/syncrunfilelog.h
@@ -24,9 +24,9 @@
namespace OCC {
class SyncFileItem;
-/*!
- * \brief The SyncRunFileLog class
- * \ingroup gui
+/**
+ * @brief The SyncRunFileLog class
+ * @ingroup gui
*/
class SyncRunFileLog
{
diff --git a/src/gui/systray.h b/src/gui/systray.h
index 45c04ab..14e9607 100644
--- a/src/gui/systray.h
+++ b/src/gui/systray.h
@@ -26,9 +26,9 @@ bool canOsXSendUserNotification();
void sendOsXUserNotification(const QString &title, const QString &message);
#endif
-/*!
- * \brief The Systray class
- * \ingroup gui
+/**
+ * @brief The Systray class
+ * @ingroup gui
*/
class Systray : public QSystemTrayIcon
{
diff --git a/src/gui/updater/ocupdater.h b/src/gui/updater/ocupdater.h
index 2523a53..51dce72 100644
--- a/src/gui/updater/ocupdater.h
+++ b/src/gui/updater/ocupdater.h
@@ -28,9 +28,9 @@ class QTimer;
namespace OCC {
-/*!
- * \brief Class that uses an ownCloud propritary XML format to fetch update information
- * \ingroup gui
+/**
+ * @brief Class that uses an ownCloud propritary XML format to fetch update information
+ * @ingroup gui
*/
class OCUpdater : public QObject, public Updater
{
@@ -75,9 +75,9 @@ private:
UpdateInfo _updateInfo;
};
-/*!
- * \brief Windows Updater Using NSIS
- * \ingroup gui
+/**
+ * @brief Windows Updater Using NSIS
+ * @ingroup gui
*/
class NSISUpdater : public OCUpdater {
Q_OBJECT
@@ -99,12 +99,12 @@ private:
};
-/*!
+/**
* @brief Updater that only implements notification for use in settings
*
* The implementation does how show popups
*
- * \ingroup gui
+ * @ingroup gui
*/
class PassiveUpdateNotifier : public OCUpdater {
Q_OBJECT
diff --git a/src/gui/wizard/abstractcredswizardpage.h b/src/gui/wizard/abstractcredswizardpage.h
index 59fe692..8f4e9ec 100644
--- a/src/gui/wizard/abstractcredswizardpage.h
+++ b/src/gui/wizard/abstractcredswizardpage.h
@@ -21,9 +21,9 @@ namespace OCC
class AbstractCredentials;
-/*!
- * \brief The AbstractCredentialsWizardPage class
- * \ingroup gui
+/**
+ * @brief The AbstractCredentialsWizardPage class
+ * @ingroup gui
*/
class AbstractCredentialsWizardPage : public QWizardPage
{
diff --git a/src/gui/wizard/owncloudadvancedsetuppage.h b/src/gui/wizard/owncloudadvancedsetuppage.h
index 3bb7138..0eabc90 100644
--- a/src/gui/wizard/owncloudadvancedsetuppage.h
+++ b/src/gui/wizard/owncloudadvancedsetuppage.h
@@ -25,9 +25,9 @@ class QProgressIndicator;
namespace OCC {
-/*!
- * \brief The OwncloudAdvancedSetupPage class
- * \ingroup gui
+/**
+ * @brief The OwncloudAdvancedSetupPage class
+ * @ingroup gui
*/
class OwncloudAdvancedSetupPage: public QWizardPage
{
diff --git a/src/gui/wizard/owncloudconnectionmethoddialog.h b/src/gui/wizard/owncloudconnectionmethoddialog.h
index 4aa4672..41cd335 100644
--- a/src/gui/wizard/owncloudconnectionmethoddialog.h
+++ b/src/gui/wizard/owncloudconnectionmethoddialog.h
@@ -25,9 +25,9 @@ namespace Ui {
class OwncloudConnectionMethodDialog;
}
-/*!
- * \brief The OwncloudConnectionMethodDialog class
- * \ingroup gui
+/**
+ * @brief The OwncloudConnectionMethodDialog class
+ * @ingroup gui
*/
class OwncloudConnectionMethodDialog : public QDialog
{
diff --git a/src/gui/wizard/owncloudhttpcredspage.h b/src/gui/wizard/owncloudhttpcredspage.h
index 76b248c..255b288 100644
--- a/src/gui/wizard/owncloudhttpcredspage.h
+++ b/src/gui/wizard/owncloudhttpcredspage.h
@@ -25,8 +25,8 @@ class QProgressIndicator;
namespace OCC {
-/*!
- * \brief The OwncloudHttpCredsPage class
+/**
+ * @brief The OwncloudHttpCredsPage class
*/
class OwncloudHttpCredsPage : public AbstractCredentialsWizardPage
{
diff --git a/src/gui/wizard/owncloudsetuppage.h b/src/gui/wizard/owncloudsetuppage.h
index 2f87057..ab32c5c 100644
--- a/src/gui/wizard/owncloudsetuppage.h
+++ b/src/gui/wizard/owncloudsetuppage.h
@@ -32,9 +32,9 @@ class QProgressIndicator;
namespace OCC {
-/*!
- * \brief The OwncloudSetupPage class
- * \ingroup gui
+/**
+ * @brief The OwncloudSetupPage class
+ * @ingroup gui
*/
class OwncloudSetupPage: public QWizardPage
{
diff --git a/src/gui/wizard/owncloudshibbolethcredspage.h b/src/gui/wizard/owncloudshibbolethcredspage.h
index dd94d07..13c09a0 100644
--- a/src/gui/wizard/owncloudshibbolethcredspage.h
+++ b/src/gui/wizard/owncloudshibbolethcredspage.h
@@ -27,9 +27,9 @@ namespace OCC {
class ShibbolethWebView;
-/*!
- * \brief The OwncloudShibbolethCredsPage class
- * \ingroup gui
+/**
+ * @brief The OwncloudShibbolethCredsPage class
+ * @ingroup gui
*/
class OwncloudShibbolethCredsPage : public AbstractCredentialsWizardPage
{
diff --git a/src/gui/wizard/owncloudwizard.h b/src/gui/wizard/owncloudwizard.h
index 5040e08..a46e284 100644
--- a/src/gui/wizard/owncloudwizard.h
+++ b/src/gui/wizard/owncloudwizard.h
@@ -31,9 +31,9 @@ class OwncloudWizardResultPage;
class AbstractCredentials;
class AbstractCredentialsWizardPage;
-/*!
- * \brief The OwncloudWizard class
- * \ingroup gui
+/**
+ * @brief The OwncloudWizard class
+ * @ingroup gui
*/
class OwncloudWizard : public QWizard
{
diff --git a/src/gui/wizard/owncloudwizardresultpage.h b/src/gui/wizard/owncloudwizardresultpage.h
index 807d07b..0e318b6 100644
--- a/src/gui/wizard/owncloudwizardresultpage.h
+++ b/src/gui/wizard/owncloudwizardresultpage.h
@@ -22,9 +22,9 @@
namespace OCC {
-/*!
- * \brief The OwncloudWizardResultPage class
- * \ingroup gui
+/**
+ * @brief The OwncloudWizardResultPage class
+ * @ingroup gui
*/
class OwncloudWizardResultPage : public QWizardPage
{
diff --git a/src/libsync/abstractnetworkjob.h b/src/libsync/abstractnetworkjob.h
index fbf82c3..0f14881 100644
--- a/src/libsync/abstractnetworkjob.h
+++ b/src/libsync/abstractnetworkjob.h
@@ -32,8 +32,8 @@ namespace OCC {
class AbstractSslErrorHandler;
/**
- * \brief The AbstractNetworkJob class
- * \ingroup libsync
+ * @brief The AbstractNetworkJob class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT AbstractNetworkJob : public QObject {
Q_OBJECT
diff --git a/src/libsync/accessmanager.h b/src/libsync/accessmanager.h
index 50942c8..675159e 100644
--- a/src/libsync/accessmanager.h
+++ b/src/libsync/accessmanager.h
@@ -23,9 +23,9 @@ class QUrl;
namespace OCC
{
-/*!
- * \brief The AccessManager class
- * \ingroup libsync
+/**
+ * @brief The AccessManager class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT AccessManager : public QNetworkAccessManager
{
diff --git a/src/libsync/account.h b/src/libsync/account.h
index 8726544..e19795b 100644
--- a/src/libsync/account.h
+++ b/src/libsync/account.h
@@ -41,9 +41,9 @@ class QuotaInfo;
class AccessManager;
-/*!
- * \brief Reimplement this to handle SSL errors from libsync
- * \ingroup libsync
+/**
+ * @brief Reimplement this to handle SSL errors from libsync
+ * @ingroup libsync
*/
class AbstractSslErrorHandler {
public:
@@ -52,9 +52,9 @@ public:
};
-/*!
- * \brief The Account class represents an account on an ownCloud Server
- * \ingroup libsync
+/**
+ * @brief The Account class represents an account on an ownCloud Server
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT Account : public QObject {
Q_OBJECT
@@ -75,7 +75,7 @@ public:
QString id() const;
/**
- * @brief Checks the Account instance is different from \param other
+ * @brief Checks the Account instance is different from @param other
*
* @returns true, if credentials or url have changed, false otherwise
*/
diff --git a/src/libsync/bandwidthmanager.h b/src/libsync/bandwidthmanager.h
index 2b5ad05..7660525 100644
--- a/src/libsync/bandwidthmanager.h
+++ b/src/libsync/bandwidthmanager.h
@@ -26,9 +26,9 @@ class UploadDevice;
class GETFileJob;
class OwncloudPropagator;
-/*!
- * \brief The BandwidthManager class
- * \ingroup libsync
+/**
+ * @brief The BandwidthManager class
+ * @ingroup libsync
*/
class BandwidthManager : public QObject {
Q_OBJECT
diff --git a/src/libsync/clientproxy.h b/src/libsync/clientproxy.h
index 7347272..93216e7 100644
--- a/src/libsync/clientproxy.h
+++ b/src/libsync/clientproxy.h
@@ -26,9 +26,9 @@ namespace OCC {
class ConfigFile;
-/*!
- * \brief The ClientProxy class
- * \ingroup libsync
+/**
+ * @brief The ClientProxy class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT ClientProxy : public QObject
{
diff --git a/src/libsync/configfile.h b/src/libsync/configfile.h
index 43524ef..4dcef77 100644
--- a/src/libsync/configfile.h
+++ b/src/libsync/configfile.h
@@ -27,9 +27,9 @@ namespace OCC {
class AbstractCredentials;
-/*!
- * \brief The ConfigFile class
- * \ingroup libsync
+/**
+ * @brief The ConfigFile class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT ConfigFile
{
diff --git a/src/libsync/connectionvalidator.h b/src/libsync/connectionvalidator.h
index 03807e1..a80d56f 100644
--- a/src/libsync/connectionvalidator.h
+++ b/src/libsync/connectionvalidator.h
@@ -23,7 +23,7 @@
namespace OCC {
-/*!
+/**
* This is a job-like class to check that the server is up and that we are connected.
* There is two entry point: checkServerAndAuth and checkAuthentication
* checkAutentication is the quick version that only do the propfind
diff --git a/src/libsync/cookiejar.h b/src/libsync/cookiejar.h
index d38b775..a83e601 100644
--- a/src/libsync/cookiejar.h
+++ b/src/libsync/cookiejar.h
@@ -20,9 +20,9 @@
namespace OCC {
-/*!
- * \brief The CookieJar class
- * \ingroup libsync
+/**
+ * @brief The CookieJar class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT CookieJar : public QNetworkCookieJar
{
diff --git a/src/libsync/discoveryphase.h b/src/libsync/discoveryphase.h
index 8539975..bd6d198 100644
--- a/src/libsync/discoveryphase.h
+++ b/src/libsync/discoveryphase.h
@@ -34,9 +34,9 @@ class Account;
* if the files are new, or changed.
*/
-/*!
- * \brief The FileStatPointer class
- * \ingroup libsync
+/**
+ * @brief The FileStatPointer class
+ * @ingroup libsync
*/
class FileStatPointer {
public:
@@ -70,12 +70,12 @@ struct DiscoveryDirectoryResult {
DiscoveryDirectoryResult() : code(EIO), listIndex(0) { }
};
-/*!
- * \brief The DiscoverySingleDirectoryJob class
+/**
+ * @brief The DiscoverySingleDirectoryJob class
*
* Run in the main thread, reporting to the DiscoveryJobMainThread object
*
- * \ingroup libsync
+ * @ingroup libsync
*/
class DiscoverySingleDirectoryJob : public QObject {
Q_OBJECT
@@ -139,12 +139,12 @@ public:
void setupHooks(DiscoveryJob* discoveryJob, const QString &pathPrefix);
};
-/*!
- * \brief The DiscoveryJob class
+/**
+ * @brief The DiscoveryJob class
*
* Lives in the other thread, deletes itself in !start()
*
- * \ingroup libsync
+ * @ingroup libsync
*/
class DiscoveryJob : public QObject {
Q_OBJECT
diff --git a/src/libsync/filesystem.h b/src/libsync/filesystem.h
index 4fd34aa..324826e 100644
--- a/src/libsync/filesystem.h
+++ b/src/libsync/filesystem.h
@@ -26,29 +26,29 @@ class QFileInfo;
namespace OCC {
-/*!
+/**
* \addtogroup libsync
* @{
*/
/**
- * \brief This file contains file system helper
+ * @brief This file contains file system helper
*/
namespace FileSystem {
-/*!
- * \brief compare two files with given filename and return true if they have the same content
+/**
+ * @brief compare two files with given filename and return true if they have the same content
*/
bool fileEquals(const QString &fn1, const QString &fn2);
-/*!
- * \brief Mark the file as hidden (only has effects on windows)
+/**
+ * @brief Mark the file as hidden (only has effects on windows)
*/
void OWNCLOUDSYNC_EXPORT setFileHidden(const QString& filename, bool hidden);
-/*!
- * \brief Get the mtime for a filepath
+/**
+ * @brief Get the mtime for a filepath
*
* Use this over QFileInfo::lastModified() to avoid timezone related bugs. See
* owncloud/core#9781 for details.
@@ -57,24 +57,24 @@ time_t OWNCLOUDSYNC_EXPORT getModTime(const QString& filename);
bool setModTime(const QString &filename, time_t modTime);
-/*!
- * \brief Get the size for a file
+/**
+ * @brief Get the size for a file
*
* Use this over QFileInfo::size() to avoid bugs with lnk files on Windows.
* See https://bugreports.qt.io/browse/QTBUG-24831.
*/
qint64 OWNCLOUDSYNC_EXPORT getSize(const QString& filename);
-/*!
- * \brief Checks whether a file exists.
+/**
+ * @brief Checks whether a file exists.
*
* Use this over QFileInfo::exists() and QFile::exists() to avoid bugs with lnk
* files, see above.
*/
bool OWNCLOUDSYNC_EXPORT fileExists(const QString& filename);
-/*!
- * \brief Rename the file \a originFileName to \a destinationFileName.
+/**
+ * @brief Rename the file \a originFileName to \a destinationFileName.
*
* It behaves as QFile::rename() but handles .lnk files correctly on Windows.
*/
@@ -82,26 +82,26 @@ bool OWNCLOUDSYNC_EXPORT rename(const QString& originFileName,
const QString& destinationFileName,
QString* errorString = NULL);
-/*!
- * \brief Check if \a fileName chas changed given previous size and mtime
+/**
+ * @brief Check if \a fileName chas changed given previous size and mtime
*
* Nonexisting files are covered through mtime: they have an mtime of -1.
*
- * \return true if the file's mtime or size are not what is expected.
+ * @return true if the file's mtime or size are not what is expected.
*/
bool fileChanged(const QString& fileName,
qint64 previousSize,
time_t previousMtime);
-/*!
- * \brief Like !fileChanged() but with verbose logging if the file *did* change.
+/**
+ * @brief Like !fileChanged() but with verbose logging if the file *did* change.
*/
bool verifyFileUnchanged(const QString& fileName,
qint64 previousSize,
time_t previousMtime);
-/*!
- * \brief renames a file, overriding the target if it exists
+/**
+ * @brief renames a file, overriding the target if it exists
*
* Rename the file \a originFileName to \a destinationFileName, and
* overwrite the destination if it already exists - as long as the
@@ -117,7 +117,7 @@ bool renameReplace(const QString &originFileName,
time_t destinationMtime,
QString *errorString);
-/*!
+/**
* Rename the file \a originFileName to \a destinationFileName, and
* overwrite the destination if it already exists - without extra checks.
*/
@@ -125,7 +125,7 @@ bool uncheckedRenameReplace(const QString &originFileName,
const QString &destinationFileName,
QString *errorString);
-/*!
+/**
* Replacement for QFile::open(ReadOnly) followed by a seek().
* This version sets a more permissive sharing mode on Windows.
*
@@ -135,7 +135,7 @@ bool uncheckedRenameReplace(const QString &originFileName,
bool openAndSeekFileSharedRead(QFile* file, QString* error, qint64 seek);
#ifdef Q_OS_WIN
-/*!
+/**
* Returns the file system used at the given path.
*/
QString fileSystemForPath(const QString & path);
@@ -149,6 +149,6 @@ QByteArray OWNCLOUDSYNC_EXPORT calcAdler32( const QString& fileName );
}
-/*! @} */
+/** @} */
}
diff --git a/src/libsync/logger.h b/src/libsync/logger.h
index 260dddc..ada8f26 100644
--- a/src/libsync/logger.h
+++ b/src/libsync/logger.h
@@ -37,9 +37,9 @@ struct Log{
QString message;
};
-/*!
- * \brief The Logger class
- * \ingroup libsync
+/**
+ * @brief The Logger class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT Logger : public QObject
{
diff --git a/src/libsync/networkjobs.h b/src/libsync/networkjobs.h
index 018f31c..eded97b 100644
--- a/src/libsync/networkjobs.h
+++ b/src/libsync/networkjobs.h
@@ -22,9 +22,9 @@ class QUrl;
namespace OCC {
-/*!
- * \brief The EntityExistsJob class
- * \ingroup libsync
+/**
+ * @brief The EntityExistsJob class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT EntityExistsJob : public AbstractNetworkJob {
Q_OBJECT
@@ -39,9 +39,9 @@ private slots:
virtual bool finished() Q_DECL_OVERRIDE;
};
-/*!
- * \brief The LsColJob class
- * \ingroup libsync
+/**
+ * @brief The LsColJob class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT LsColXMLParser : public QObject {
Q_OBJECT
@@ -89,15 +89,15 @@ private:
QList<QByteArray> _properties;
};
-/*!
- * \brief The PropfindJob class
+/**
+ * @brief The PropfindJob class
*
* Setting the desired properties with setProperties() is mandatory.
*
* Note that this job is only for querying one item.
* There is also the LsColJob which can be used to list collections
*
- * \ingroup libsync
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT PropfindJob : public AbstractNetworkJob {
Q_OBJECT
@@ -128,8 +128,8 @@ private:
};
/**
- * \brief The MkColJob class
- * \ingroup libsync
+ * @brief The MkColJob class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT MkColJob : public AbstractNetworkJob {
Q_OBJECT
@@ -144,9 +144,9 @@ private slots:
virtual bool finished() Q_DECL_OVERRIDE;
};
-/*!
- * \brief The CheckServerJob class
- * \ingroup libsync
+/**
+ * @brief The CheckServerJob class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT CheckServerJob : public AbstractNetworkJob {
Q_OBJECT
@@ -172,8 +172,8 @@ private:
};
-/*!
- * \brief The RequestEtagJob class
+/**
+ * @brief The RequestEtagJob class
*/
class OWNCLOUDSYNC_EXPORT RequestEtagJob : public AbstractNetworkJob {
Q_OBJECT
@@ -201,7 +201,7 @@ private slots:
* The recieved QVariantMap is empty in case of error or otherwise is a map as parsed by QtJson
* \encode
*
- * \ingroup libsync
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT JsonApiJob : public AbstractNetworkJob {
Q_OBJECT
diff --git a/src/libsync/owncloudpropagator.h b/src/libsync/owncloudpropagator.h
index 388c89d..441462c 100644
--- a/src/libsync/owncloudpropagator.h
+++ b/src/libsync/owncloudpropagator.h
@@ -40,13 +40,13 @@ namespace OCC {
class SyncJournalDb;
class OwncloudPropagator;
-/*!
- * \brief the base class of propagator jobs
+/**
+ * @brief the base class of propagator jobs
*
* This can either be a job, or a container for jobs.
* If it is a composite jobs, it then inherits from PropagateDirectory
*
- * \ingroup libsync
+ * @ingroup libsync
*/
class PropagatorJob : public QObject {
Q_OBJECT
@@ -156,9 +156,9 @@ public slots:
};
-/*!
- * \brief Propagate a directory, and all its sub entries.
- * \ingroup libsync
+/**
+ * @brief Propagate a directory, and all its sub entries.
+ * @ingroup libsync
*/
class PropagateDirectory : public PropagatorJob {
Q_OBJECT
@@ -219,9 +219,9 @@ private slots:
};
-/*!
- * \brief Dummy job that just mark it as completed and ignored
- * \ingroup libsync
+/**
+ * @brief Dummy job that just mark it as completed and ignored
+ * @ingroup libsync
*/
class PropagateIgnoreJob : public PropagateItemJob {
Q_OBJECT
@@ -352,9 +352,9 @@ private:
};
-/*!
- * \brief Job that wait for all the poll jobs to be completed
- * \ingroup libsync
+/**
+ * @brief Job that wait for all the poll jobs to be completed
+ * @ingroup libsync
*/
class CleanupPollsJob : public QObject {
Q_OBJECT
diff --git a/src/libsync/owncloudtheme.h b/src/libsync/owncloudtheme.h
index 767f5ae..8eade6a 100644
--- a/src/libsync/owncloudtheme.h
+++ b/src/libsync/owncloudtheme.h
@@ -19,9 +19,9 @@
namespace OCC {
-/*!
- * \brief The ownCloudTheme class
- * \ingroup libsync
+/**
+ * @brief The ownCloudTheme class
+ * @ingroup libsync
*/
class ownCloudTheme : public Theme
{
diff --git a/src/libsync/ownsql.h b/src/libsync/ownsql.h
index e7bc7fe..bcff7f5 100644
--- a/src/libsync/ownsql.h
+++ b/src/libsync/ownsql.h
@@ -23,9 +23,9 @@
namespace OCC {
-/*!
- * \brief The SqlDatabase class
- * \ingroup libsync
+/**
+ * @brief The SqlDatabase class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT SqlDatabase
{
@@ -52,9 +52,9 @@ private:
};
-/*!
- * \brief The SqlQuery class
- * \ingroup libsync
+/**
+ * @brief The SqlQuery class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT SqlQuery
{
diff --git a/src/libsync/progressdispatcher.h b/src/libsync/progressdispatcher.h
index 7047d41..23cccd0 100644
--- a/src/libsync/progressdispatcher.h
+++ b/src/libsync/progressdispatcher.h
@@ -27,9 +27,9 @@
namespace OCC {
-/*!
- * \brief The ProgressInfo class
- * \ingroup libsync
+/**
+ * @brief The ProgressInfo class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT ProgressInfo : public QObject
{
diff --git a/src/libsync/propagatedownload.h b/src/libsync/propagatedownload.h
index de94869..85ea82d 100644
--- a/src/libsync/propagatedownload.h
+++ b/src/libsync/propagatedownload.h
@@ -21,9 +21,9 @@
namespace OCC {
-/*!
- * \brief The GETFileJob class
- * \ingroup libsync
+/**
+ * @brief The GETFileJob class
+ * @ingroup libsync
*/
class GETFileJob : public AbstractNetworkJob {
Q_OBJECT
@@ -102,9 +102,9 @@ private slots:
void slotMetaDataChanged();
};
-/*!
- * \brief The PropagateDownloadFileQNAM class
- * \ingroup libsync
+/**
+ * @brief The PropagateDownloadFileQNAM class
+ * @ingroup libsync
*/
class PropagateDownloadFileQNAM : public PropagateItemJob {
Q_OBJECT
diff --git a/src/libsync/propagateremotedelete.h b/src/libsync/propagateremotedelete.h
index 861d92c..f44ccd0 100644
--- a/src/libsync/propagateremotedelete.h
+++ b/src/libsync/propagateremotedelete.h
@@ -18,9 +18,9 @@
namespace OCC {
-/*!
- * \brief The DeleteJob class
- * \ingroup libsync
+/**
+ * @brief The DeleteJob class
+ * @ingroup libsync
*/
class DeleteJob : public AbstractNetworkJob {
Q_OBJECT
@@ -37,9 +37,9 @@ signals:
void finishedSignal();
};
-/*!
- * \brief The PropagateRemoteDelete class
- * \ingroup libsync
+/**
+ * @brief The PropagateRemoteDelete class
+ * @ingroup libsync
*/
class PropagateRemoteDelete : public PropagateItemJob {
Q_OBJECT
diff --git a/src/libsync/propagateremotemkdir.h b/src/libsync/propagateremotemkdir.h
index b43690b..9dcbb73 100644
--- a/src/libsync/propagateremotemkdir.h
+++ b/src/libsync/propagateremotemkdir.h
@@ -18,9 +18,9 @@
namespace OCC {
-/*!
- * \brief The PropagateRemoteMkdir class
- * \ingroup libsync
+/**
+ * @brief The PropagateRemoteMkdir class
+ * @ingroup libsync
*/
class PropagateRemoteMkdir : public PropagateItemJob {
Q_OBJECT
diff --git a/src/libsync/propagateremotemove.h b/src/libsync/propagateremotemove.h
index 405f669..3ce54f4 100644
--- a/src/libsync/propagateremotemove.h
+++ b/src/libsync/propagateremotemove.h
@@ -18,9 +18,9 @@
namespace OCC {
-/*!
- * \brief The MoveJob class
- * \ingroup libsync
+/**
+ * @brief The MoveJob class
+ * @ingroup libsync
*/
class MoveJob : public AbstractNetworkJob {
Q_OBJECT
@@ -38,9 +38,9 @@ signals:
void finishedSignal();
};
-/*!
- * \brief The PropagateRemoteMove class
- * \ingroup libsync
+/**
+ * @brief The PropagateRemoteMove class
+ * @ingroup libsync
*/
class PropagateRemoteMove : public PropagateItemJob {
Q_OBJECT
diff --git a/src/libsync/propagateupload.h b/src/libsync/propagateupload.h
index e756345..f01b65f 100644
--- a/src/libsync/propagateupload.h
+++ b/src/libsync/propagateupload.h
@@ -24,9 +24,9 @@
namespace OCC {
class BandwidthManager;
-/*!
- * \brief The UploadDevice class
- * \ingroup libsync
+/**
+ * @brief The UploadDevice class
+ * @ingroup libsync
*/
class UploadDevice : public QIODevice {
Q_OBJECT
@@ -78,9 +78,9 @@ protected slots:
void slotJobUploadProgress(qint64 sent, qint64 t);
};
-/*!
- * \brief The PUTFileJob class
- * \ingroup libsync
+/**
+ * @brief The PUTFileJob class
+ * @ingroup libsync
*/
class PUTFileJob : public AbstractNetworkJob {
Q_OBJECT
@@ -123,12 +123,12 @@ private slots:
#endif
};
-/*!
- * \brief This job implements the assynchronous PUT
+/**
+ * @brief This job implements the assynchronous PUT
*
* If the server replies to a PUT with a OC-Finish-Poll url, we will query this url until the server
* replies with an etag. https://github.com/owncloud/core/issues/12097
- * \ingroup libsync
+ * @ingroup libsync
*/
class PollJob : public AbstractNetworkJob {
Q_OBJECT
@@ -154,9 +154,9 @@ signals:
void finishedSignal();
};
-/*!
- * \brief The PropagateUploadFileQNAM class
- * \ingroup libsync
+/**
+ * @brief The PropagateUploadFileQNAM class
+ * @ingroup libsync
*/
class PropagateUploadFileQNAM : public PropagateItemJob {
Q_OBJECT
diff --git a/src/libsync/propagator_legacy.h b/src/libsync/propagator_legacy.h
index 067df36..75ec8fd 100644
--- a/src/libsync/propagator_legacy.h
+++ b/src/libsync/propagator_legacy.h
@@ -39,9 +39,9 @@ struct ScopedPointerHelpers {
-/*!
- * \brief Abstract class for neon job. Lives in the neon thread
- * \ingroup libsync
+/**
+ * @brief Abstract class for neon job. Lives in the neon thread
+ * @ingroup libsync
*/
class PropagateNeonJob : public PropagateItemJob {
Q_OBJECT
@@ -78,9 +78,9 @@ public:
JobParallelism parallelism() Q_DECL_OVERRIDE { return WaitForFinished; }
};
-/*!
- * \brief The UpdateMTimeAndETagJob class
- * \ingroup libsync
+/**
+ * @brief The UpdateMTimeAndETagJob class
+ * @ingroup libsync
*/
class UpdateMTimeAndETagJob : public PropagateNeonJob {
Q_OBJECT
@@ -89,9 +89,9 @@ public:
void start() Q_DECL_OVERRIDE;
};
-/*!
- * \brief The PropagateUploadFileLegacy class
- * \ingroup libsync
+/**
+ * @brief The PropagateUploadFileLegacy class
+ * @ingroup libsync
*/
class PropagateUploadFileLegacy: public PropagateNeonJob {
Q_OBJECT
diff --git a/src/libsync/propagatorjobs.h b/src/libsync/propagatorjobs.h
index a1f045d..537bba9 100644
--- a/src/libsync/propagatorjobs.h
+++ b/src/libsync/propagatorjobs.h
@@ -34,9 +34,9 @@ static const char checkSumSHA1C[] = "SHA1";
static const char checkSumAdlerC[] = "Adler32";
static const char checkSumAdlerUpperC[] = "ADLER32";
-/*!
- * \brief Declaration of the other propagation jobs
- * \ingroup libsync
+/**
+ * @brief Declaration of the other propagation jobs
+ * @ingroup libsync
*/
class PropagateLocalRemove : public PropagateItemJob {
Q_OBJECT
@@ -45,9 +45,9 @@ public:
void start() Q_DECL_OVERRIDE;
};
-/*!
- * \brief The PropagateLocalMkdir class
- * \ingroup libsync
+/**
+ * @brief The PropagateLocalMkdir class
+ * @ingroup libsync
*/
class PropagateLocalMkdir : public PropagateItemJob {
Q_OBJECT
@@ -57,9 +57,9 @@ public:
};
-/*!
- * \brief The PropagateLocalRename class
- * \ingroup libsync
+/**
+ * @brief The PropagateLocalRename class
+ * @ingroup libsync
*/
class PropagateLocalRename : public PropagateItemJob {
Q_OBJECT
diff --git a/src/libsync/syncengine.h b/src/libsync/syncengine.h
index 5050b37..3f346d7 100644
--- a/src/libsync/syncengine.h
+++ b/src/libsync/syncengine.h
@@ -46,9 +46,9 @@ class SyncJournalFileRecord;
class SyncJournalDb;
class OwncloudPropagator;
-/*!
- * \brief The SyncEngine class
- * \ingroup libsync
+/**
+ * @brief The SyncEngine class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT SyncEngine : public QObject
{
diff --git a/src/libsync/syncfileitem.h b/src/libsync/syncfileitem.h
index 9c0df6c..33e5be1 100644
--- a/src/libsync/syncfileitem.h
+++ b/src/libsync/syncfileitem.h
@@ -32,9 +32,9 @@
namespace OCC {
-/*!
- * \brief The SyncFileItem class
- * \ingroup libsync
+/**
+ * @brief The SyncFileItem class
+ * @ingroup libsync
*/
class SyncFileItem {
public:
diff --git a/src/libsync/syncfilestatus.h b/src/libsync/syncfilestatus.h
index b3eb9ed..2f54b16 100644
--- a/src/libsync/syncfilestatus.h
+++ b/src/libsync/syncfilestatus.h
@@ -20,9 +20,9 @@
namespace OCC {
-/*!
- * \brief The SyncFileStatus class
- * \ingroup libsync
+/**
+ * @brief The SyncFileStatus class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT SyncFileStatus
{
diff --git a/src/libsync/syncjournaldb.h b/src/libsync/syncjournaldb.h
index 62f9b7b..f2139bd 100644
--- a/src/libsync/syncjournaldb.h
+++ b/src/libsync/syncjournaldb.h
@@ -26,11 +26,11 @@ namespace OCC {
class SyncJournalFileRecord;
class SyncJournalErrorBlacklistRecord;
-/*!
- * \brief Class that handle the sync database
+/**
+ * @brief Class that handle the sync database
*
* This class is thread safe. All public function are locking the mutex.
- * \ingroup libsync
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT SyncJournalDb : public QObject
{
diff --git a/src/libsync/syncjournalfilerecord.h b/src/libsync/syncjournalfilerecord.h
index dfa9251..be5f7d6 100644
--- a/src/libsync/syncjournalfilerecord.h
+++ b/src/libsync/syncjournalfilerecord.h
@@ -23,9 +23,9 @@ namespace OCC {
class SyncFileItem;
-/*!
- * \brief The SyncJournalFileRecord class
- * \ingroup libsync
+/**
+ * @brief The SyncJournalFileRecord class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT SyncJournalFileRecord
{
diff --git a/src/libsync/syncresult.h b/src/libsync/syncresult.h
index 14990d2..14e062c 100644
--- a/src/libsync/syncresult.h
+++ b/src/libsync/syncresult.h
@@ -25,9 +25,9 @@
namespace OCC
{
-/*!
- * \brief The SyncResult class
- * \ingroup libsync
+/**
+ * @brief The SyncResult class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT SyncResult
{
diff --git a/src/libsync/theme.h b/src/libsync/theme.h
index 9f21f90..b977272 100644
--- a/src/libsync/theme.h
+++ b/src/libsync/theme.h
@@ -29,9 +29,9 @@ namespace OCC {
class SyncResult;
-/*!
- * \brief The Theme class
- * \ingroup libsync
+/**
+ * @brief The Theme class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT Theme : public QObject
{
diff --git a/src/libsync/transmissionchecksumvalidator.h b/src/libsync/transmissionchecksumvalidator.h
index 2d81619..fe56729 100644
--- a/src/libsync/transmissionchecksumvalidator.h
+++ b/src/libsync/transmissionchecksumvalidator.h
@@ -22,9 +22,9 @@
namespace OCC {
-/*!
- * \brief The TransmissionChecksumValidator class
- * \ingroup libsync
+/**
+ * @brief The TransmissionChecksumValidator class
+ * @ingroup libsync
*/
class OWNCLOUDSYNC_EXPORT TransmissionChecksumValidator : public QObject
{
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-client.git
More information about the Pkg-owncloud-commits
mailing list