feat: updated doxyfile

Doxyfile

@@ -227,7 +227,7 @@ JAVADOC_BANNER         = NO
 # requiring an explicit \brief command for a brief description.)
 # The default value is: NO.
 
-QT_AUTOBRIEF           = NO
+QT_AUTOBRIEF           = YES
 
 # The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a
 # multi-line C++ special comment block (i.e. a block of //! or /// comments) as
@@ -524,13 +524,13 @@ EXTRACT_ALL            = NO
 # be included in the documentation.
 # The default value is: NO.
 
-EXTRACT_PRIVATE        = NO
+EXTRACT_PRIVATE        = YES
 
 # If the EXTRACT_PRIV_VIRTUAL tag is set to YES, documented private virtual
 # methods of a class will be included in the documentation.
 # The default value is: NO.
 
-EXTRACT_PRIV_VIRTUAL   = NO
+EXTRACT_PRIV_VIRTUAL   = YES
 
 # If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal
 # scope will be included in the documentation.
@@ -542,7 +542,7 @@ EXTRACT_PACKAGE        = NO
 # included in the documentation.
 # The default value is: NO.
 
-EXTRACT_STATIC         = NO
+EXTRACT_STATIC         = YES
 
 # If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined
 # locally in source files will be included in the documentation. If set to NO,
@@ -1416,7 +1416,7 @@ HTML_EXTRA_FILES       =
 # The default value is: AUTO_LIGHT.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_COLORSTYLE        = AUTO_LIGHT
+HTML_COLORSTYLE        = TOGGLE
 
 # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
 # will adjust the colors in the style sheet and background images according to

game_state.hpp

@@ -4,6 +4,10 @@
 #include <godot_cpp/classes/resource.hpp>
 
 namespace utils {
+/*! Parent class for saved game state.
+ *
+ * Inherit and add godot properties to save persistently.
+ */
 class GameState : public godot::Resource {
     GDCLASS(GameState, godot::Resource);
     static void _bind_methods();

player_input.hpp

@@ -20,6 +20,7 @@ class PlayerInput : public gd::Node {
     static void _bind_methods();
 public:
     /*! A PlayerInput action listener.
+     *
      * A listener is a combination of a positive and negative action and a callable.
      * The expected callable signature is `void (godot::Ref<godot::InputEvent> event, float value)`
      * actions can also be "special" actions prefixed with `_`.
@@ -28,14 +29,18 @@ public:
     struct Listener {
         friend class PlayerInput;
     private:
-        // the two actions, evaluated as positive - negative
+        //! Negative action on axis, evaluates to -1.
         gd::String actionNegative{""};
+        //! Positive action on axis, evaluates to +1.
         gd::String actionPositive{""};
-        // the last cached action, if the newest result matches this, the event will be considered
-        // duplicate and ignored (not passed to listener)
+        /*! The last cached action.
+         *
+         * If the newest result matches this, the event will be considered duplicate and ignored (not passed to listener)
+         */
         float lastCached{0.f};
+        //! The listening function.
         gd::Callable callable;
-        // if either actionNegative or actionPositive is a _mouse_ event this will be true
+        //! If either actionNegative or actionPositive is a _mouse_ event this will be true
         bool isMouseEvent{false};
 
     public:
@@ -44,15 +49,17 @@ public:
         Listener(gd::String action, gd::Callable callable);
         // evaluate the current state of an action.
         static std::optional<float> evaluate_action(gd::String const &action);
-        // check if this event has any chance to result in a trigger, does not evaluate the event or
-        // poll current input state
+        /*! Check if this event has any chance to result in a trigger.
+         *
+         * Does not evaluate the event or poll current input state
+         */
         bool has_changed(gd::Ref<gd::InputEvent> const &event);
-        // evaluate the event for changes to either actionPositive or actionNegative
+        //! evaluate the event for changes to either actionPositive or actionNegative
         float evaluate(gd::Ref<gd::InputEvent> const &event);
-
         bool operator==(PlayerInput::Listener const& b) const;
     };
 public:
+    //! Returns the last stored mouse delta.
     static gd::Vector2 get_last_mouse_motion();
 
     virtual void _enter_tree() override;
@@ -60,27 +67,41 @@ public:
     virtual void _unhandled_input(gd::Ref<gd::InputEvent> const &event) override;
     virtual void _process(double deltaTime) override;
 
+    //! Start listening for action.
     void listen_to(Listener const &listener);
+    /*! Start listening for action.
+     *
+     * Shorthand for `listen_to(Listener(action, callable))`.
+     */
     void listen_to(gd::String action, gd::Callable callable);
+    /*! Start listening for action.
+     *
+     * Shorthand for `listen_to(Listener(negative, positive, callable))`.
+     */
     void listen_to(gd::String negative, gd::String positive, gd::Callable callable);
 
+    //! Remove any listeners related to node.
     void stop_listening(Node *node);
+    //! Remove listeners exactly equal to listener.
     void stop_listening(Listener const &listener);
+    //! Remove all listeners.
     void clear_listeners();
-
+    //! set the device observe events from.
     void set_device(int id);
 private:
-    // the last mouse motion, updated by the primary instance
+    //! The last mouse motion, updated by the primary instance
     static gd::Vector2 lastMouseMotion;
-    // does a primary instance exist
+    //! Does a primary instance exist
     static bool primaryExists;
-    // is this the primary instance
-    // the primary instance is responsible for updating static
-    // variables like lastMouseMotion
+    /*! Is this the primary instance.
+     *
+     * The primary instance is responsible for updating static variables like lastMouseMotion.
+     */
     bool isPrimary{false};
+    //! which device to observe events from.
     int device{-1}; 
 
-    // current listeners for this instance
+    //! current listeners for this instance
     gd::Vector<Listener> listeners{};
 };
 }