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.
This commit is contained in:
Xi Ruoyao 2023-02-10 02:38:29 +08:00
parent 6c22d02146
commit e2de81fd07
No known key found for this signature in database
GPG Key ID: ACAAD20E19E710E3

View File

@ -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>