From 26c597d579e9061c0e3ef37d298f3d0d4a42d56a Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Fri, 3 Mar 2023 12:45:01 +0800
Subject: [PATCH] libnotify: Tell how to generate API doc with gi-docgen

---
 x/lib/libnotify.xml | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/x/lib/libnotify.xml b/x/lib/libnotify.xml
index d8a3a266cc..071050f812 100644
--- a/x/lib/libnotify.xml
+++ b/x/lib/libnotify.xml
@@ -83,7 +83,7 @@
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend="gtk-doc"/> and
+      <xref linkend="gi-docgen"/> and
       <xref linkend="xmlto"/>
     </para>
 
@@ -126,6 +126,17 @@ ninja</userinput></screen>
       This package does not come with a test suite.
     </para>
 
+    <para>
+      If you have <xref linkend='gi-docgen'/> installed and wish to build
+      the API documentation for this package, issue:
+    </para>
+
+    <!-- No &libnotify-version; here because we'll mv the doc dir anyway -->
+<screen remap='doc'><userinput>sed "/docs_dir =/s@\$@ / 'libnotify'@" \
+    -i ../docs/reference/meson.build   &amp;&amp;
+meson configure -Dgtk_doc=true         &amp;&amp;
+ninja</userinput></screen>
+
     <para>
       Now, as the <systemitem class="username">root</systemitem> user:
     </para>
@@ -140,13 +151,6 @@ mv -v /usr/share/doc/libnotify{,-&libnotify-version;}</userinput></screen>
 
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
       href="../../xincludes/meson-buildtype-release.xml"/>
-
-    <para>
-      <parameter>-Dgtk_doc=false</parameter>: Remove this parameter if
-      <application>GTK-Doc</application> is installed and you wish to rebuild
-      and install the API documentation.
-    </para>
-
   </sect2>
 
   <sect2 role="content">