Merge branch 'master' into fix-compiler-warnings

libcockatrice_card/libcockatrice/card/card_info.h

@@ -1,9 +1,3 @@
-/**
- * @file card_info.h
- * @ingroup Cards
- * @brief TODO: Document this.
- */
-
 #ifndef CARD_INFO_H
 #define CARD_INFO_H
 
@@ -54,6 +48,10 @@ class CardInfo : public QObject
     Q_OBJECT
 
 private:
+    /** @name Private Card Properties
+     *  @anchor PrivateCardProperties
+     */
+    ///@{
     CardInfoPtr smartThis;                         ///< Smart pointer to self for safe cross-references.
     QString name;                                  ///< Full name of the card.
     QString simpleName;                            ///< Simplified name for fuzzy matching.
@@ -69,6 +67,7 @@ private:
     bool landscapeOrientation;                     ///< Orientation flag for rendering.
     int tableRow;                                  ///< Row index in a table or visual representation.
     bool upsideDownArt;                            ///< Whether artwork is flipped for visual purposes.
+    ///@}
 
 public:
     /**
@@ -161,7 +160,7 @@ public:
      */
     CardInfoPtr clone() const
     {
-        CardInfoPtr newCardInfo = CardInfoPtr(new CardInfo(*this));
+        auto newCardInfo = CardInfoPtr(new CardInfo(*this));
         newCardInfo->setSmartPointer(newCardInfo); // Set the smart pointer for the new instance
         return newCardInfo;
     }

libcockatrice_card/libcockatrice/card/database/card_database.h

@@ -1,10 +1,3 @@
-/**
- * @file card_database.h
- * @ingroup CardDatabase
- * @brief The CardDatabase is responsible for holding the card and set maps, managing card additions/removals,
- * and providing access to sets and card querying via CardDatabaseQuerier.
- */
-
 #ifndef CARDDATABASE_H
 #define CARDDATABASE_H
 

libcockatrice_card/libcockatrice/card/database/card_database_loader.h

@@ -1,12 +1,3 @@
-/**
- * @file card_database_loader.h
- * @ingroup CardDatabase
- * @brief The CardDatabaseLoader is responsible for discovering, loading, and saving card databases from files on disk.
- *
- * This class interacts with available parsers to populate a CardDatabase instance. It also handles
- * loading main, token, spoiler, and custom card databases.
- */
-
 #ifndef COCKATRICE_CARD_DATABASE_LOADER_H
 #define COCKATRICE_CARD_DATABASE_LOADER_H
 

libcockatrice_card/libcockatrice/card/printing/exact_card.h

@@ -5,7 +5,7 @@
 
 /**
  * @class ExactCard
- * @ingroup Cards
+ * @ingroup CardPrintings
  *
  * @brief Represents a specific card instance, defined by its CardInfo
  *        and a particular printing.

libcockatrice_card/libcockatrice/card/printing/printing_info.h

@@ -14,7 +14,7 @@ using SetToPrintingsMap = QMap<QString, QList<PrintingInfo>>;
 
 /**
  * @class PrintingInfo
- * @ingroup Cards
+ * @ingroup CardPrintings
  *
  * @brief Represents metadata for a specific variation of a card within a set.
  *

libcockatrice_card/libcockatrice/card/set/card_set.h

@@ -15,7 +15,7 @@ using CardSetPtr = QSharedPointer<CardSet>;
 
 /**
  * @class CardSet
- * @ingroup Cards
+ * @ingroup CardSets
  *
  * @brief A collection of cards grouped under a common identifier.
  *

libcockatrice_card/libcockatrice/card/set/card_set_comparator.h

@@ -1,6 +1,6 @@
 /**
  * @file card_set_comparator.h
- * @ingroup Cards
+ * @ingroup CardSets
  * @brief TODO: Document this.
  */
 

libcockatrice_card/libcockatrice/card/set/card_set_list.h

@@ -8,7 +8,7 @@
 
 /**
  * @class CardSetList
- * @ingroup Cards
+ * @ingroup CardSets
  *
  * @brief A list-like container for CardSet objects with extended management methods.
  *