From 7ce7fe488981fcb33b7870a084685e16bda51f1e Mon Sep 17 00:00:00 2001
From: Pcornat <pcornat@protonmail.com>
Date: Sat, 10 Jan 2026 16:13:38 +0100
Subject: [PATCH] Documentation

---
 include/basic_data.hpp     |  3 +++
 include/context_window.hpp |  7 +++++++
 include/opengl_context.hpp |  5 +++++
 include/window.hpp         | 21 +++++++++++++++++++++
 4 files changed, 36 insertions(+)

diff --git a/include/basic_data.hpp b/include/basic_data.hpp
index 6802774..58e63a7 100644
--- a/include/basic_data.hpp
+++ b/include/basic_data.hpp
@@ -5,6 +5,9 @@
 #include <string_view>
 
 namespace data {
+    /*!
+     * \brief This interface is used by the window::Window class in its callbacks.
+     */
     class BasicData {
     public:
         virtual ~BasicData() noexcept = default;
diff --git a/include/context_window.hpp b/include/context_window.hpp
index b7fee92..9023317 100644
--- a/include/context_window.hpp
+++ b/include/context_window.hpp
@@ -4,6 +4,9 @@
 #include <GLFW/glfw3.h>
 
 namespace window {
+    /*!
+     * \brief This class is a RAII object for GLFW library.
+     */
     class ContextWindow final {
     private:
         bool init{ false };
@@ -11,6 +14,10 @@ namespace window {
     public:
         ContextWindow() noexcept = delete;
 
+        /*!
+         * \brief Constructor to initialize GLFW library
+         * \param error_clbk GLFW error callback. Can be null
+         */
         explicit ContextWindow(const GLFWerrorfun error_clbk) noexcept;
 
         ~ContextWindow() noexcept;
diff --git a/include/opengl_context.hpp b/include/opengl_context.hpp
index a673fd6..2330889 100644
--- a/include/opengl_context.hpp
+++ b/include/opengl_context.hpp
@@ -10,6 +10,11 @@ namespace gui {
 }
 
 namespace opengl {
+    /*!
+     * \brief It takes a window object to get OpenGL context in current thread.
+     * \param win Window to use to init the GLEW context
+     * \return True: glew init, false: failed
+     */
     [[nodiscard]] bool init_glew(const gui::Window &win) noexcept;
 }
 
diff --git a/include/window.hpp b/include/window.hpp
index 1e6a2cb..caa2999 100644
--- a/include/window.hpp
+++ b/include/window.hpp
@@ -30,8 +30,10 @@ namespace gui {
 
         static void window_pos_callback(GLFWwindow *window, int xpos, int ypos);
 
+        //! RAII window.
         std::unique_ptr<GLFWwindow, decltype(&glfwDestroyWindow)> wwindow{ nullptr, glfwDestroyWindow };
 
+        //! Modules used in callbacks.
         modulesType modules;
 
         explicit Window(const bool debugOpengl,
@@ -46,6 +48,14 @@ namespace gui {
 
         Window(Window &&window) noexcept;
 
+        /*!
+         * \brief
+         * \param [in] framebufferCallback Self-explicit
+         * \param [in] debugOpengl Boolean to choose if it activates OpenGL's debug mode
+         * \param [in] shared Another window pointer that shares the OpenGL's context
+         * \param [in] initializer To initialize Window::modules
+         * \return Optional containing a Window object if it was successful.
+         */
         [[nodiscard]] static std::optional<Window> create_window(
             GLFWframebuffersizefun framebufferCallback,
             const bool debugOpengl,
@@ -74,10 +84,21 @@ namespace gui {
         Window &operator=(Window other) noexcept;
     };
 
+    /*!
+     * \brief It has to be used **before** creating a Window to put color channels on 10 bits resolution.
+     */
     void color_10_bits() noexcept;
 
+    /*!
+     * \brief It is used to check the color depth for OpenGL's context.
+     * \param color_depth The color depth to check. Most of the time, 10 or 8 bits.
+     * \return True: color depth is the input one, else it is not.
+     */
     [[nodiscard]] bool check_color_depth(int color_depth) noexcept;
 
+    /*!
+     * \brief It can be used to activate OpenGL's debug mode before creating a window.
+     */
     void opengl_debug() noexcept;
 }