docs: Move the GSlice documentation to Markdown

Helps: #3037

docs/reference/glib/glib.toml.in

@@ -45,6 +45,8 @@ content_files = [
 
   "macros.md",
   "conversion-macros.md",
+
+  "memory-slices.md",
   "error-reporting.md",
   "logging.md",
   "main-loop.md",

docs/reference/glib/memory-slices.md

@@ -0,0 +1,58 @@
+Title: Memory Slices
+
+# Memory Slices
+
+GSlice was a space-efficient and multi-processing scalable way to allocate
+equal sized pieces of memory. Since GLib 2.76, its implementation has been
+removed and it calls `g_malloc()` and `g_free()`, because the performance of the
+system-default allocators has improved on all platforms since GSlice was
+written.
+
+The GSlice APIs have not been deprecated, as they are widely in use and doing
+so would be very disruptive for little benefit.
+
+New code should be written using [`func@GLib.new`]/[`func@GLib.malloc`] and
+[`func@GLib.free`]. There is no particular benefit in porting existing code away
+from `g_slice_new()`/`g_slice_free()` unless it’s being rewritten anyway.
+
+Here is an example for using the slice allocator:
+
+```c
+gchar *mem[10000];
+gint i;
+
+// Allocate 10000 blocks.
+for (i = 0; i < 10000; i++)
+  {
+    mem[i] = g_slice_alloc (50);
+
+    // Fill in the memory with some junk.
+    for (j = 0; j < 50; j++)
+      mem[i][j] = i * j;
+  }
+
+// Now free all of the blocks.
+for (i = 0; i < 10000; i++)
+  g_slice_free1 (50, mem[i]);
+```
+
+And here is an example for using the using the slice allocator with data
+structures:
+
+```c
+GRealArray *array;
+
+// Allocate one block, using the g_slice_new() macro.
+array = g_slice_new (GRealArray);
+
+// We can now use array just like a normal pointer to a structure.
+array->data            = NULL;
+array->len             = 0;
+array->alloc           = 0;
+array->zero_terminated = (zero_terminated ? 1 : 0);
+array->clear           = (clear ? 1 : 0);
+array->elt_size        = elt_size;
+
+// We can free the block, so it can be reused.
+g_slice_free (GRealArray, array);
+```

docs/reference/glib/meson.build

@@ -157,6 +157,7 @@ expand_content_files = [
   'i18n.md',
   'logging.md',
   'main-loop.md',
+  'memory-slices.md',
   'reference-counting.md',
   'testing.md',
   'threads.md',

glib/gslice.c

@@ -30,65 +30,6 @@
 #include "glib_trace.h"
 #include "gprintf.h"
 
-/**
- * SECTION:memory_slices
- * @title: Memory Slices
- * @short_description: efficient way to allocate groups of equal-sized
- *     chunks of memory
- *
- * GSlice was a space-efficient and multi-processing scalable way to allocate
- * equal sized pieces of memory. Since GLib 2.76, its implementation has been
- * removed and it calls g_malloc() and g_free_sized(), because the performance
- * of the system-default allocators has improved on all platforms since GSlice
- * was written.
- *
- * The GSlice APIs have not been deprecated, as they are widely in use and doing
- * so would be very disruptive for little benefit.
- *
- * New code should be written using g_new()/g_malloc() and g_free_sized() or
- * g_free(). There is no particular benefit in porting existing code away from
- * g_slice_new()/g_slice_free() unless it’s being rewritten anyway.
- *
- * Here is an example for using the slice allocator:
- * |[<!-- language="C" --> 
- * gchar *mem[10000];
- * gint i;
- *
- * // Allocate 10000 blocks.
- * for (i = 0; i < 10000; i++)
- *   {
- *     mem[i] = g_slice_alloc (50);
- *
- *     // Fill in the memory with some junk.
- *     for (j = 0; j < 50; j++)
- *       mem[i][j] = i * j;
- *   }
- *
- * // Now free all of the blocks.
- * for (i = 0; i < 10000; i++)
- *   g_slice_free1 (50, mem[i]);
- * ]|
- *
- * And here is an example for using the using the slice allocator
- * with data structures:
- * |[<!-- language="C" --> 
- * GRealArray *array;
- *
- * // Allocate one block, using the g_slice_new() macro.
- * array = g_slice_new (GRealArray);
- *
- * // We can now use array just like a normal pointer to a structure.
- * array->data            = NULL;
- * array->len             = 0;
- * array->alloc           = 0;
- * array->zero_terminated = (zero_terminated ? 1 : 0);
- * array->clear           = (clear ? 1 : 0);
- * array->elt_size        = elt_size;
- *
- * // We can free the block, so it can be reused.
- * g_slice_free (GRealArray, array);
- * ]|
- */
 
 /* --- auxiliary functions --- */
 void