Standardize Doxygen documentation style to @brief format

Convert leading triple-slash (///) comments to JavaDoc-style
    (/** @brief */) documentation blocks across game, deck list, and
    card library modules.

    - Leading /// comments → /** @brief ... */
    - Enum value comments → ///<
    - Trailing ///< member comments are unchanged
This commit is contained in:
DawnFire42 2026-05-13 12:56:22 -04:00
parent 0549892092
commit f361cd65e0
No known key found for this signature in database
GPG key ID: 24BB855EE2911B33
26 changed files with 207 additions and 177 deletions

View file

@ -30,27 +30,27 @@ class CardDatabase : public QObject
Q_OBJECT
protected:
/// Controller to determine set priority when choosing preferred printings.
/** @brief Controller to determine set priority when choosing preferred printings. */
ICardSetPriorityController *setPriorityController;
/// Cards indexed by exact name
/** @brief Cards indexed by exact name. */
CardNameMap cards;
/// Cards indexed by simplified name (normalized)
/** @brief Cards indexed by simplified name (normalized). */
CardNameMap simpleNameCards;
/// Sets indexed by short name
/** @brief Sets indexed by short name. */
SetNameMap sets;
FormatRulesNameMap formats;
/// Loader responsible for file discovery and parsing
/** @brief Loader responsible for file discovery and parsing. */
CardDatabaseLoader *loader;
/// Current load status of the database
/** @brief Current load status of the database. */
LoadStatus loadStatus;
/// Querier for higher-level card lookups
/** @brief Querier for higher-level card lookups. */
CardDatabaseQuerier *querier;
private:
@ -64,7 +64,7 @@ private:
*/
void refreshCachedReverseRelatedCards();
/// Mutexes for thread safety
/** @brief Mutexes for thread safety. */
QBasicMutex *clearDatabaseMutex = new QBasicMutex(), *addCardMutex = new QBasicMutex(),
*removeCardMutex = new QBasicMutex();