docs: Move the windows SECTION

Move it to a separate file.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>

Helps: #3037

docs/reference/glib/glib.toml.in

@@ -73,6 +73,7 @@ content_files = [
   "threads.md",
   "spawn.md",
   "unix.md",
+  "windows.md",
   "random.md",
   "numerical.md",
   "markup.md",

docs/reference/glib/meson.build

@@ -182,6 +182,7 @@ expand_content_files = [
   'uuid.md',
   'version.md',
   'warnings.md',
+  'windows.md',
 ]
 
 glib_toml = configure_file(input: 'glib.toml.in', output: 'glib.toml', configuration: toml_conf)

docs/reference/glib/windows.md

@@ -0,0 +1,26 @@
+Title: Windows-specific Utilities
+SPDX-License-Identifier: LGPL-2.1-or-later
+SPDX-FileCopyrightText: 2005 Ross Burton
+
+# Windows-specific Utilities
+
+These functions provide some level of Unix emulation on the
+Windows platform. If your application really needs the POSIX
+APIs, we suggest you try the [Cygwin project](https://cygwin.com/).
+
+ * [type@GLib.Win32OSType]
+ * [func@GLib.win32_check_windows_version]
+ * [func@GLib.win32_get_command_line]
+ * [func@GLib.win32_error_message]
+ * [func@GLib.win32_getlocale]
+ * [func@GLib.win32_get_package_installation_directory]
+ * [func@GLib.win32_get_package_installation_directory_of_module]
+ * [func@GLib.win32_get_package_installation_subdirectory]
+ * [func@GLib.win32_get_windows_version]
+ * [func@GLib.win32_locale_filename_from_utf8]
+ * [func@GLib.WIN32_HAVE_WIDECHAR_API]
+ * [func@GLib.WIN32_IS_NT_BASED]
+
+## Deprecated API
+
+ * [func@GLib.WIN32_DLLMAIN_FOR_DLL_NAME]

glib/docs.c

@@ -2862,16 +2862,6 @@
 
 /* Windows Compatibility Functions {{{1 */
 
-/**
- * SECTION:windows
- * @title: Windows Compatibility Functions
- * @short_description: UNIX emulation on Windows
- *
- * These functions provide some level of UNIX emulation on the
- * Windows platform. If your application really needs the POSIX
- * APIs, we suggest you try the Cygwin project.
- */
-
 /**
  * MAXPATHLEN:
  *