docs: Move the shell SECTION

Move it to a separate file.

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

Helps: #3037

docs/reference/glib/glib.toml.in

@@ -69,6 +69,7 @@ content_files = [
   "base64.md",
   "goption.md",
   "data-structures.md",
+  "shell.md",
   "uuid.md",
   "unicode.md",
   "version.md",

docs/reference/glib/meson.build

@@ -168,6 +168,7 @@ expand_content_files = [
   'markup.md',
   'goption.md',
   'data-structures.md',
+  'shell.md',
   'unicode.md',
   'uuid.md',
   'version.md',

docs/reference/glib/shell.md

@@ -0,0 +1,15 @@
+Title: Shell Utilities
+SPDX-License-Identifier: LGPL-2.1-or-later
+SPDX-FileCopyrightText: 2014 Matthias Clasen
+
+# Shell Utilities
+
+GLib provides the functions [func@GLib.shell_quote] and
+[func@GLib.shell_unquote] to handle shell-like quoting in strings. The function
+[func@GLib.shell_parse_argv] parses a string similar to the way a POSIX shell
+(`/bin/sh`) would.
+
+Note that string handling in shells has many obscure and historical
+corner-cases which these functions do not necessarily reproduce. They
+are good enough in practice, though.
+

glib/gshell.c

@@ -33,20 +33,6 @@
 #include "glibintl.h"
 #include "gthread.h"
 
-/**
- * SECTION:shell
- * @title: Shell-related Utilities
- * @short_description: shell-like commandline handling
- *
- * GLib provides the functions g_shell_quote() and g_shell_unquote()
- * to handle shell-like quoting in strings. The function g_shell_parse_argv()
- * parses a string similar to the way a POSIX shell (/bin/sh) would.
- *
- * Note that string handling in shells has many obscure and historical
- * corner-cases which these functions do not necessarily reproduce. They
- * are good enough in practice, though.
- */
-
 /**
  * G_SHELL_ERROR:
  *