From 2d216d4d8c04881061c8f4ef1a924b579bf4d3a9 Mon Sep 17 00:00:00 2001
From: Sam Thursfield <sam.thursfield@codethink.co.uk>
Date: Thu, 23 Mar 2023 14:11:26 +0100
Subject: [PATCH] Link goption documentation to GOptionContext type

This makes the goption overview visible in the gi-docgen docs as part of
the GOptionContext type. Previously it was not visible anywhere.

Fixes https://gitlab.gnome.org/GNOME/glib/-/issues/2953
---
 docs/reference/glib/glib-docs.xml        | 2 +-
 docs/reference/glib/glib-sections.txt.in | 2 +-
 glib/goption.c                           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/reference/glib/glib-docs.xml b/docs/reference/glib/glib-docs.xml
index a21bfde98..e378fd956 100644
--- a/docs/reference/glib/glib-docs.xml
+++ b/docs/reference/glib/glib-docs.xml
@@ -85,7 +85,7 @@
     <xi:include href="xml/guri.xml" />
     <xi:include href="xml/ghostutils.xml" />
     <xi:include href="xml/shell.xml" />
-    <xi:include href="xml/option.xml" />
+    <xi:include href="xml/goptioncontext.xml" />
     <xi:include href="xml/patterns.xml" />
     <xi:include href="xml/gregex.xml" />
     <xi:include href="regex-syntax.xml" />
diff --git a/docs/reference/glib/glib-sections.txt.in b/docs/reference/glib/glib-sections.txt.in
index f617bbd4b..3703198bd 100644
--- a/docs/reference/glib/glib-sections.txt.in
+++ b/docs/reference/glib/glib-sections.txt.in
@@ -1353,7 +1353,7 @@ g_shell_error_quark
 
 <SECTION>
 <TITLE>Commandline option parser</TITLE>
-<FILE>option</FILE>
+<FILE>goptioncontext</FILE>
 GOptionError
 G_OPTION_ERROR
 GOptionArgFunc
diff --git a/glib/goption.c b/glib/goption.c
index 0b3a05e90..64aed7a03 100644
--- a/glib/goption.c
+++ b/glib/goption.c
@@ -20,7 +20,7 @@
  */
 
 /**
- * SECTION:option
+ * SECTION:goptioncontext
  * @Short_description: parses commandline options
  * @Title: Commandline option parser
  *