From e2de81fd079bd8e5c261d110c5f8855348002fb8 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Fri, 10 Feb 2023 02:38:29 +0800
Subject: [PATCH] libsecret: Doc needs gi-docgen now

Though the option is still named gtk_doc, actually it invokes gi-docgen.

By the way, run the tests with dbus-run-session or almost all will fail
w/o a d-bus address.
---
 gnome/platform/libsecret.xml | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/gnome/platform/libsecret.xml b/gnome/platform/libsecret.xml
index 58dc005a03..9df5bf1b74 100644
--- a/gnome/platform/libsecret.xml
+++ b/gnome/platform/libsecret.xml
@@ -82,7 +82,7 @@
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend="gtk-doc"/> and
+      <xref linkend="gi-docgen"/> and
       <xref linkend="DocBook"/>,
       <xref linkend="docbook-xsl"/>,
       <xref linkend="libxslt"/> (to build manual pages), and
@@ -138,9 +138,17 @@ ninja</userinput></screen>
 <screen role="root"><userinput>ninja install</userinput></screen>
 
     <para>
-      To test the results, issue: <command>ninja test</command>.
+      To test the results, issue: <command>dbus-run-session ninja test</command>.
     </para>
 
+    <para>
+      If gi-docgen is installed and the <option>-Dgtk_doc=false</option>
+      has been removed, as the &root; user, issue the following command to
+      fix the name of the installed documentation directory:
+    </para>
+
+<screen role="nodump"><userinput>mv -v /usr/share/doc/libsecret-{1,&libsecret-version;}</userinput></screen>
+
   </sect2>
 
   <sect2 role="commands">
@@ -150,7 +158,7 @@ ninja</userinput></screen>
       href="../../xincludes/meson-buildtype-release.xml"/>
 
     <para>
-      <parameter>-Dgtk_doc=false</parameter>: Remove this if you have <xref linkend="gtk-doc"/> installed
+      <parameter>-Dgtk_doc=false</parameter>: Remove this if you have <xref linkend="gi-docgen"/> installed
       and want to rebuild the documentation with it.
     </para>
 
@@ -185,7 +193,7 @@ ninja</userinput></screen>
         </seg>
         <seg>
           /usr/include/libsecret-1 and
-          /usr/share/gtk-doc/html/libsecret-1
+          /usr/share/doc/libsecret-&libsecret-version;
         </seg>
       </seglistitem>
     </segmentedlist>