docs: Move the gpollableutils SECTION

Move it to a separate page.

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

Helps: #3037

docs/reference/gio/gio.toml.in

@@ -46,6 +46,8 @@ content_files = [
 
   "error.md",
 
+  "pollable-utils.md",
+
   "dbus-error.md",
   "dbus-introspection.md",
   "dbus-name-owning.md",

docs/reference/gio/meson.build

@@ -239,6 +239,7 @@ expand_content_files = [
   'migrating-gnome-vfs.md',
   'networking.md',
   'overview.md',
+  'pollable-utils.md',
   'tls-overview.md',
 ]
 

docs/reference/gio/pollable-utils.md

@@ -0,0 +1,15 @@
+Title: Pollable Utility Functions
+SPDX-License-Identifier: LGPL-2.1-or-later
+SPDX-FileCopyrightText: 2012 Dan Winship
+
+# Pollable Utility Functions
+
+Utility functions for [iface@Gio.PollableInputStream] and
+[iface@Gio.PollableOutputStream] implementations.
+
+ * [func@Gio.pollable_source_new]
+ * [func@Gio.pollable_source_new_full]
+ * [func@Gio.pollable_stream_read]
+ * [func@Gio.pollable_stream_write]
+ * [func@Gio.pollable_stream_write_all]
+

gio/gpollableutils.c

@@ -26,15 +26,6 @@
 #include "gasynchelper.h"
 #include "glibintl.h"
 
-/**
- * SECTION:gpollableutils
- * @short_description: Utilities for pollable streams
- * @include: gio/gio.h
- *
- * Utility functions for #GPollableInputStream and
- * #GPollableOutputStream implementations.
- */
-
 typedef struct {
   GSource       source;