docs(src): add examples alias and general cleanup (#2763)

src/globals.h

@@ -1,27 +1,44 @@
 /**
  * @file globals.h
- * @brief Header for globally accessible variables and functions.
+ * @brief Declarations for globally accessible variables and functions.
  */
 #pragma once
 
 #include "entry_handler.h"
 #include "thread_pool.h"
 
+/**
+ * @brief A thread pool for processing tasks.
+ */
 extern thread_pool_util::ThreadPool task_pool;
+
+/**
+ * @brief A boolean flag to indicate whether the cursor should be displayed.
+ */
 extern bool display_cursor;
 
 #ifdef _WIN32
   // Declare global singleton used for NVIDIA control panel modifications
   #include "platform/windows/nvprefs/nvprefs_interface.h"
+
+/**
+ * @brief A global singleton used for NVIDIA control panel modifications.
+ */
 extern nvprefs::nvprefs_interface nvprefs_instance;
 #endif
 
+/**
+ * @brief Handles process-wide communication.
+ */
 namespace mail {
 #define MAIL(x)                         \
   constexpr auto x = std::string_view { \
     #x                                  \
   }
 
+  /**
+   * @brief A process-wide communication mechanism.
+   */
   extern safe::mail_t man;
 
   // Global mail