[Documentation] Sort *every* file into a doxygen group. (#6198)

* Sort *every* file into a doxygen group.

Took 7 hours 9 minutes

Took 18 seconds

Took 2 minutes

* Lint some ingroup definitions.

Took 10 minutes


Took 2 seconds

* Just include the groups in the Doxyfile in this commit.

Took 3 minutes

* Update some group comments so they link!

Took 14 minutes

---------

Co-authored-by: Lukas Brübach <Bruebach.Lukas@bdosecurity.de>

cockatrice/src/game/player/card_menu_action_type.h

@@ -1,3 +1,9 @@
+/**
+ * @file card_menu_action_type.h
+ * @ingroup GameMenusPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_CARD_MENU_ACTION_TYPE_H
 #define COCKATRICE_CARD_MENU_ACTION_TYPE_H
 

cockatrice/src/game/player/event_processing_options.h

@@ -1,3 +1,9 @@
+/**
+ * @file event_processing_options.h
+ * @ingroup GameLogicPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_EVENT_PROCESSING_OPTIONS_H
 #define COCKATRICE_EVENT_PROCESSING_OPTIONS_H
 

cockatrice/src/game/player/menu/card_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file card_menu.h
+ * @ingroup GameMenusCards
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_CARD_MENU_H
 #define COCKATRICE_CARD_MENU_H
 

cockatrice/src/game/player/menu/custom_zone_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file custom_zone_menu.h
+ * @ingroup GameMenusZones
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_CUSTOM_ZONE_MENU_H
 #define COCKATRICE_CUSTOM_ZONE_MENU_H
 

cockatrice/src/game/player/menu/grave_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file grave_menu.h
+ * @ingroup GameMenusZones
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_GRAVE_MENU_H
 #define COCKATRICE_GRAVE_MENU_H
 

cockatrice/src/game/player/menu/hand_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file hand_menu.h
+ * @ingroup GameMenusZones
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_HAND_MENU_H
 #define COCKATRICE_HAND_MENU_H
 

cockatrice/src/game/player/menu/library_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file library_menu.h
+ * @ingroup GameMenusZones
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_LIBRARY_MENU_H
 #define COCKATRICE_LIBRARY_MENU_H
 

cockatrice/src/game/player/menu/move_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file move_menu.h
+ * @ingroup GameMenusZones
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_MOVE_MENU_H
 #define COCKATRICE_MOVE_MENU_H
 #include <QMenu>

cockatrice/src/game/player/menu/player_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_menu.h
+ * @ingroup GameMenusPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PLAYER_MENU_H
 #define COCKATRICE_PLAYER_MENU_H
 

cockatrice/src/game/player/menu/pt_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file pt_menu.h
+ * @ingroup GameMenusCards
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PT_MENU_H
 #define COCKATRICE_PT_MENU_H
 #include <QMenu>

cockatrice/src/game/player/menu/rfg_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file rfg_menu.h
+ * @ingroup GameMenusZones
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_RFG_MENU_H
 #define COCKATRICE_RFG_MENU_H
 

cockatrice/src/game/player/menu/say_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file say_menu.h
+ * @ingroup GameMenusPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_SAY_MENU_H
 #define COCKATRICE_SAY_MENU_H
 

cockatrice/src/game/player/menu/sideboard_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file sideboard_menu.h
+ * @ingroup GameMenusZones
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_SIDEBOARD_MENU_H
 #define COCKATRICE_SIDEBOARD_MENU_H
 

cockatrice/src/game/player/menu/utility_menu.h

@@ -1,3 +1,9 @@
+/**
+ * @file utility_menu.h
+ * @ingroup GameMenusPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_UTILITY_MENU_H
 #define COCKATRICE_UTILITY_MENU_H
 

cockatrice/src/game/player/player.h

@@ -1,3 +1,9 @@
+/**
+ * @file player.h
+ * @ingroup GameLogicPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef PLAYER_H
 #define PLAYER_H
 

cockatrice/src/game/player/player_actions.h

@@ -1,3 +1,10 @@
+/**
+ * @file player_actions.h
+ *  @ingroup GameLogicActions
+ * @ingroup GameLogicPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PLAYER_ACTIONS_H
 #define COCKATRICE_PLAYER_ACTIONS_H
 #include "event_processing_options.h"

cockatrice/src/game/player/player_area.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_area.h
+ * @ingroup GameGraphicsPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PLAYER_AREA_H
 #define COCKATRICE_PLAYER_AREA_H
 

cockatrice/src/game/player/player_event_handler.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_event_handler.h
+ * @ingroup GameLogicPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PLAYER_EVENT_HANDLER_H
 #define COCKATRICE_PLAYER_EVENT_HANDLER_H
 #include "event_processing_options.h"

cockatrice/src/game/player/player_graphics_item.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_graphics_item.h
+ * @ingroup GameGraphicsPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PLAYER_GRAPHICS_ITEM_H
 #define COCKATRICE_PLAYER_GRAPHICS_ITEM_H
 #include "../game_scene.h"

cockatrice/src/game/player/player_info.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_info.h
+ * @ingroup GameLogicPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PLAYER_INFO_H
 #define COCKATRICE_PLAYER_INFO_H
 

cockatrice/src/game/player/player_list_widget.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_list_widget.h
+ * @ingroup GameWidgets
+ * @brief TODO: Document this.
+ */
+
 #ifndef PLAYERLISTWIDGET_H
 #define PLAYERLISTWIDGET_H
 

cockatrice/src/game/player/player_manager.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_manager.h
+ * @ingroup GameLogicPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef COCKATRICE_PLAYER_MANAGER_H
 #define COCKATRICE_PLAYER_MANAGER_H
 

cockatrice/src/game/player/player_target.h

@@ -1,3 +1,9 @@
+/**
+ * @file player_target.h
+ * @ingroup GameGraphicsPlayers
+ * @brief TODO: Document this.
+ */
+
 #ifndef PLAYERTARGET_H
 #define PLAYERTARGET_H