docs: document ownership in Server_Card::setStashedCard

This commit is contained in:
AI-scor 2026-11-11 02:18:51 +01:00
parent 4581e649ac
commit dd7ac44927

View file

@ -215,6 +215,12 @@ public:
{ {
attachedCards.removeOne(card); attachedCards.removeOne(card);
} }
/**
* @brief Stashes @p card inside this card, taking ownership of it: it is deleted with this
* card unless the caller takes it back with takeStashedCard().
* @note A token is never stashed — if @p card would be destroyed on zone change, its own
* stashed card (if any) is kept in its place and @p card is deleted during the call.
*/
void setStashedCard(Server_Card *card) void setStashedCard(Server_Card *card)
{ {
// setStashedCard should only be called on creation of a new card, so // setStashedCard should only be called on creation of a new card, so