docs(windows): Add documentation comment for cursor visibility fix

Signed-off-by: tstokes22 <[email protected]>

	modified:   src/main.cpp
	modified:   src/platform/windows/misc.h

Signed-off-by: tstokes22 <[email protected]>

	modified:   src/main.cpp
	modified:   src/platform/windows/misc.h

Signed-off-by: tstokes22 <[email protected]>

	modified:   src/main.cpp
	modified:   src/platform/windows/misc.h

Author: tstokes22

src/main.cpp

@@ -8,13 +8,6 @@
 #include <fstream>
 #include <iostream>
 
-// clang-format off
-#define WIN32_LEAN_AND_MEAN
-#include <windows.h> // must come before dbt.h
-#include <winsock2.h>
-#include <dbt.h>
-// clang-format on
-
 // local includes
 #include "confighttp.h"
 #include "display_device.h"
@@ -30,7 +23,13 @@
 #include "video.h"
 
 #ifdef _WIN32
+  #define WIN32_LEAN_AND_MEAN
   #include "platform/windows/misc.h"
+  
+  // clang-format off
+  #include <Windows.h>  // must come before dbt.h
+  #include <Dbt.h>
+  // clang-format on
 #endif
 
 extern "C" {

src/platform/windows/misc.h

@@ -34,5 +34,11 @@ namespace platf {
    */
   std::string to_utf8(const std::wstring &string);
 
+  /**
+   * @brief Checks if a mouse is physically present and, if not, toggles Mouse Keys
+   * to force the software cursor to become visible.
+   * @details This is used as a workaround for KVM switches that do not send
+   * standard device removal messages, which can cause the cursor to disappear.
+   */
   void check_and_force_cursor_visibility();
 }  // namespace platf