jeirmeister/Cockatrice
1
0
Fork 0
mirror of https://github.com/Cockatrice/Cockatrice.git synced 2026-07-07 05:53:59 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Standardize Doxygen documentation style to @brief format

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

24
libcockatrice_deck_list/libcockatrice/deck_list/tree/abstract_deck_list_card_node.h
View file

@ -58,40 +58,40 @@ public:
{
}
/// @return The number of copies of this card in the deck.
/** @return The number of copies of this card in the deck. */
[[nodiscard]] virtual int getNumber() const = 0;
/// @param _number Set the number of copies of this card.
/** @param _number Set the number of copies of this card. */
virtual void setNumber(int _number) = 0;
/// @return The display name of this card.
/** @return The display name of this card. */
[[nodiscard]] QString getName() const override = 0;
/// @param _name Set the display name of this card.
/** @param _name Set the display name of this card. */
virtual void setName(const QString &_name) = 0;
/// @return The provider identifier for this card (e.g., UUID).
/** @return The provider identifier for this card (e.g., UUID). */
[[nodiscard]] virtual QString getCardProviderId() const override = 0;
/// @param _cardProviderId Set the provider identifier for this card.
/** @param _cardProviderId Set the provider identifier for this card. */
virtual void setCardProviderId(const QString &_cardProviderId) = 0;
/// @return The abbreviated set code (e.g., "NEO").
/** @return The abbreviated set code (e.g., "NEO"). */
[[nodiscard]] virtual QString getCardSetShortName() const override = 0;
/// @param _cardSetShortName Set the abbreviated set code.
/** @param _cardSetShortName Set the abbreviated set code. */
virtual void setCardSetShortName(const QString &_cardSetShortName) = 0;
/// @return The collector number of the card within its set.
/** @return The collector number of the card within its set. */
[[nodiscard]] virtual QString getCardCollectorNumber() const override = 0;
/// @param _cardSetNumber Set the collector number.
/** @param _cardSetNumber Set the collector number. */
virtual void setCardCollectorNumber(const QString &_cardSetNumber) = 0;
/// @return The format legality of the card
/** @return The format legality of the card. */
virtual bool getFormatLegality() const = 0;
/// @param _formatLegal If the card is considered legal
/** @param _formatLegal If the card is considered legal. */
virtual void setFormatLegality(const bool _formatLegal) = 0;
/**

4
libcockatrice_deck_list/libcockatrice/deck_list/tree/abstract_deck_list_node.h
View file

@ -101,7 +101,7 @@ public:
*/
explicit AbstractDecklistNode(InnerDecklistNode *_parent = nullptr, int position = -1);
/// Virtual destructor. Child classes must clean up their resources.
/** @brief Virtual destructor. Child classes must clean up their resources. */
virtual ~AbstractDecklistNode() = default;
/**
@ -136,7 +136,7 @@ public:
*/
[[nodiscard]] virtual bool isDeckHeader() const = 0;
/// @return The parent node, or nullptr if this is the root.
/** @return The parent node, or nullptr if this is the root. */
[[nodiscard]] InnerDecklistNode *getParent() const
{
return parent;

26
libcockatrice_deck_list/libcockatrice/deck_list/tree/deck_list_card_node.h
View file

@ -93,79 +93,79 @@ public:
*/
explicit DecklistCardNode(DecklistCardNode *other, InnerDecklistNode *_parent);
/// @return The quantity of this card.
/** @return The quantity of this card. */
[[nodiscard]] int getNumber() const override
{
return number;
}
/// @param _number Set the quantity of this card.
/** @param _number Set the quantity of this card. */
void setNumber(int _number) override
{
number = _number;
}
/// @return The display name of this card.
/** @return The display name of this card. */
[[nodiscard]] QString getName() const override
{
return name;
}
/// @param _name Set the display name of this card.
/** @param _name Set the display name of this card. */
void setName(const QString &_name) override
{
name = _name;
}
/// @return The provider identifier for this card.
/** @return The provider identifier for this card. */
[[nodiscard]] QString getCardProviderId() const override
{
return cardProviderId;
}
/// @param _providerId Set the provider identifier for this card.
/** @param _providerId Set the provider identifier for this card. */
void setCardProviderId(const QString &_providerId) override
{
cardProviderId = _providerId;
}
/// @return The short set code (e.g., "NEO").
/** @return The short set code (e.g., "NEO"). */
[[nodiscard]] QString getCardSetShortName() const override
{
return cardSetShortName;
}
/// @param _cardSetShortName Set the short set code.
/** @param _cardSetShortName Set the short set code. */
void setCardSetShortName(const QString &_cardSetShortName) override
{
cardSetShortName = _cardSetShortName;
}
/// @return The collector number of this card within its set.
/** @return The collector number of this card within its set. */
[[nodiscard]] QString getCardCollectorNumber() const override
{
return cardSetNumber;
}
/// @param _cardSetNumber Set the collector number.
/** @param _cardSetNumber Set the collector number. */
void setCardCollectorNumber(const QString &_cardSetNumber) override
{
cardSetNumber = _cardSetNumber;
}
/// @return The format legality of the card
/** @return The format legality of the card. */
[[nodiscard]] bool getFormatLegality() const override
{
return formatLegal;
}
/// @param _formatLegal If the card is considered legal
/** @param _formatLegal If the card is considered legal. */
void setFormatLegality(const bool _formatLegal) override
{
formatLegal = _formatLegal;
}
/// @return Always false; card nodes are not deck headers.
/** @return Always false; card nodes are not deck headers. */
[[nodiscard]] bool isDeckHeader() const override
{
return false;

22
libcockatrice_deck_list/libcockatrice/deck_list/tree/inner_deck_list_node.h
View file

@ -18,11 +18,11 @@
#include "abstract_deck_list_node.h"
/// Constant for the "main" deck zone name.
/** @brief Constant for the "main" deck zone name. */
#define DECK_ZONE_MAIN "main"
/// Constant for the "sideboard" zone name.
/** @brief Constant for the "sideboard" zone name. */
#define DECK_ZONE_SIDE "side"
/// Constant for the "tokens" zone name.
/** @brief Constant for the "tokens" zone name. */
#define DECK_ZONE_TOKENS "tokens"
/**
@ -93,13 +93,13 @@ public:
*/
void setSortMethod(DeckSortMethod method) override;
/// @return The internal name of this node.
/** @return The internal name of this node. */
[[nodiscard]] QString getName() const override
{
return name;
}
/// @param _name Set the internal name of this node.
/** @param _name Set the internal name of this node. */
void setName(const QString &_name)
{
name = _name;
@ -122,25 +122,25 @@ public:
*/
[[nodiscard]] virtual QString getVisibleName() const;
/// @return Always empty for container nodes.
/** @return Always empty for container nodes. */
[[nodiscard]] QString getCardProviderId() const override
{
return "";
}
/// @return Always empty for container nodes.
/** @return Always empty for container nodes. */
[[nodiscard]] QString getCardSetShortName() const override
{
return "";
}
/// @return Always empty for container nodes.
/** @return Always empty for container nodes. */
[[nodiscard]] QString getCardCollectorNumber() const override
{
return "";
}
/// @return Always true; InnerDecklistNode represents deck structure.
/** @return Always true; InnerDecklistNode represents deck structure. */
[[nodiscard]] bool isDeckHeader() const override
{
return true;
@ -196,10 +196,10 @@ public:
*/
bool compare(AbstractDecklistNode *other) const override;
/// @copydoc compare(AbstractDecklistNode*) const
/** @copydoc compare(AbstractDecklistNode*) const */
bool compareNumber(AbstractDecklistNode *other) const;
/// @copydoc compare(AbstractDecklistNode*) const
/** @copydoc compare(AbstractDecklistNode*) const */
bool compareName(AbstractDecklistNode *other) const;
/**