Changeset e2de81fd for gnome/platform

Timestamp:

02/09/2023 06:38:29 PM (20 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

11.3, 12.0, 12.1, 12.2, gimp3, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/for-12.3, xry111/llvm18, xry111/spidermonkey128, xry111/xf86-video-removal

Children:

05355b8, 7fb10a3d

Parents:

6c22d02

Message:

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.

File:

• gnome/platform/libsecret.xml (modified) (4 diffs)

gnome/platform/libsecret.xml

@@ -83 +83 @@
     <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"/>,
@@ -139 +139 @@
 
     <para>
-      To test the results, issue: <command>ninja test</command>.
-    </para>
+      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>
@@ -151 +159 @@
 
     <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>
@@ -186 +194 @@
         <seg>
           /usr/include/libsecret-1 and
-          /usr/share/gtk-doc/html/libsecret-1
+          /usr/share/doc/libsecret-&libsecret-version;
         </seg>
       </seglistitem>