From 0bd9b849315846cd94c44923af1c4115933eddbd Mon Sep 17 00:00:00 2001
From: BruebachL <44814898+BruebachL@users.noreply.github.com>
Date: Tue, 11 Nov 2025 06:46:18 +0100
Subject: [PATCH] Doxygen printing_info.h (#6300)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Took 4 minutes

Co-authored-by: Lukas Brübach <Bruebach.Lukas@bdosecurity.de>
---
 .../card/printing/printing_info.h             | 67 +++++++++++++++++--
 1 file changed, 63 insertions(+), 4 deletions(-)

diff --git a/libcockatrice_card/libcockatrice/card/printing/printing_info.h b/libcockatrice_card/libcockatrice/card/printing/printing_info.h
index c2afe983a..cacb98068 100644
--- a/libcockatrice_card/libcockatrice/card/printing/printing_info.h
+++ b/libcockatrice_card/libcockatrice/card/printing/printing_info.h
@@ -13,43 +13,102 @@ class PrintingInfo;
 using SetToPrintingsMap = QMap<QString, QList<PrintingInfo>>;
 
 /**
- * Info relating to a specific printing for a card.
+ * @class PrintingInfo
+ * @ingroup Cards
+ *
+ * @brief Represents metadata for a specific variation of a card within a set.
+ *
+ * A card can have multiple variations across sets. PrintingInfo associates
+ * a card with one such variation, and provides per-printing attributes
+ * such as identifiers or additional properties.
+ *
+ * Equality is defined as both the set and the property values being equal.
  */
 class PrintingInfo
 {
 public:
+    /**
+     * @brief Constructs a PrintingInfo associated with a specific set.
+     *
+     * @param _set The set this printing belongs to (defaults to null).
+     */
     explicit PrintingInfo(const CardSetPtr &_set = nullptr);
+
+    /**
+     * @brief Destroys the PrintingInfo.
+     *
+     * Defaulted since no special cleanup is required.
+     */
     ~PrintingInfo() = default;
 
+    /**
+     * @brief Equality operator.
+     *
+     * Two PrintingInfo objects are equal if they refer to the same set
+     * and contain the exact same property key/value pairs.
+     *
+     * @param other Another PrintingInfo to compare against.
+     * @return True if both set and properties are equal, otherwise false.
+     */
     bool operator==(const PrintingInfo &other) const
     {
         return this->set == other.set && this->properties == other.properties;
     }
 
 private:
-    CardSetPtr set;
-    // per-printing card properties;
-    QVariantHash properties;
+    CardSetPtr set;          ///< The set this variation belongs to.
+    QVariantHash properties; ///< Key-value store for variation-specific attributes.
 
 public:
+    /**
+     * @brief Returns the set this printing belongs to.
+     *
+     * @return Pointer to the associated CardSet.
+     */
     CardSetPtr getSet() const
     {
         return set;
     }
 
+    /**
+     * @brief Returns the list of property names defined for this printing.
+     *
+     * @return List of keys stored in the properties map.
+     */
     QStringList getProperties() const
     {
         return properties.keys();
     }
+
+    /**
+     * @brief Retrieves the value of a specific property.
+     *
+     * @param propertyName The key name of the property to query.
+     * @return The property value as a string, or an empty string if not set.
+     */
     QString getProperty(const QString &propertyName) const
     {
         return properties.value(propertyName).toString();
     }
+
+    /**
+     * @brief Sets or updates the value of a specific property.
+     *
+     * If the property already exists, its value is replaced.
+     *
+     * @param _name The name of the property.
+     * @param _value The string value to assign.
+     */
     void setProperty(const QString &_name, const QString &_value)
     {
         properties.insert(_name, _value);
     }
 
+    /**
+     * @brief Returns the providerID for this printing.
+     *
+     * @return A string representing the providerID.
+     */
     QString getUuid() const;
 };