Doxygen

src/blackcore/blackcore.h

@@ -14,13 +14,19 @@
  */
 
 /*!
- * \namespace BlackCore::Settings
- * Core settings traits.
+ * \namespace BlackCore::Data
+ * Core data traits (aka cached values) and classes.
  */
 
 /*!
- * \namespace BlackCore::Data
- * Core data traits (aka cached values) and classes.
+ * \namespace BlackCore::Db
+ * Classes interacting with the swift database (aka "datastore"). This includes the readers and related classes.
+ * Related model classes can be found in BlackMisc::Db
+ */
+
+/*!
+ * \namespace BlackCore::Settings
+ * Core settings traits.
  */
 
 /*!

src/blackcore/db/airportdatareader.h

@@ -23,9 +23,7 @@ namespace BlackCore
 {
     namespace Db
     {
-        /**
-         * Reader for airport database.
-         */
+        //! Reader for airport database data.
         class BLACKCORE_EXPORT CAirportDataReader : public CDatabaseReader
         {
             Q_OBJECT

src/blackcore/db/backgrounddataupdater.h

@@ -23,9 +23,7 @@ namespace BlackCore
 {
     namespace Db
     {
-        /**
-         * Update and consolidation of DB data
-         */
+        //! Update and consolidation of DB data
         class BLACKCORE_EXPORT CBackgroundDataUpdater : public BlackMisc::CContinuousWorker
         {
             Q_OBJECT

src/blackcore/db/databaseauthentication.h

@@ -21,13 +21,13 @@
 #include <QString>
 
 class QNetworkReply;
-namespace BlackMisc { namespace Network { class CAuthenticatedUser; } }
 
+namespace BlackMisc { namespace Network { class CAuthenticatedUser; } }
 namespace BlackCore
 {
     namespace Db
     {
-        //! Databse user used with swift DB. Features role and cookie handling.
+        //! Database user used with swift DB. Features role and cookie handling.
         class BLACKCORE_EXPORT CDatabaseAuthenticationService: public QObject
         {
             Q_OBJECT

src/blackcore/db/networkwatchdog.h

@@ -22,9 +22,7 @@ namespace BlackCore
 {
     namespace Db
     {
-        /**
-         * Monitoring the swift DB, internet access, shared URL
-         */
+        //! Monitoring the swift DB, internet access, shared URLs
         class CNetworkWatchdog : public BlackMisc::CContinuousWorker
         {
             Q_OBJECT