Changeset f56d2e7 for general

Timestamp:

01/18/2023 02:32:27 PM (18 months ago)

Author:

Pierre Labastie <pierre.labastie@…>

Branches:

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

Children:

0f9a1f08

Parents:

e0fff61

Message:

change gi-docgen ulink to xref

Location:

general

Files:

• genlib/libgusb.xml (modified) (2 diffs)
• genlib/libportal.xml (modified) (2 diffs)
• graphlib/librsvg.xml (modified) (2 diffs)

general/genlib/libgusb.xml

@@ -87 +87 @@
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <ulink url="https://download.gnome.org/sources/gi-docgen/">gi-docgen</ulink>
+      <xref linkend="gi-docgen"/>
     </para>
 
@@ -128 +128 @@
     <para>
       <parameter>-Ddocs=false</parameter>: building documentation needs
-      <application>gi-docgen</application>. Remove this switch if you have
+      <xref linkend="gi-docgen"/>. Remove this switch if you have
       installed <application>gi-docgen</application>, and you wish to build
       the API documentation.

general/genlib/libportal.xml

@@ -83 +83 @@
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend="vala"/> and
-      <ulink url="&gi-docgen-url;">gi-docgen</ulink>
+      <xref linkend="gi-docgen"/> and
+      <xref linkend="vala"/>
     </para>
 
@@ -138 +138 @@
     <para>
       <parameter>-Ddocs=false</parameter>: Remove this parameter if
-      <application>gi-docgen</application> is installed and you wish to rebuild
+      <xref linkend="gi-docgen"/> is installed and you wish to rebuild
       and install the API documentation.
     </para>

general/graphlib/librsvg.xml

@@ -87 +87 @@
     <para role="optional">
       <xref linkend="docutils"/> (for man pages),
+      <xref linkend="gi-docgen"/> (for documentation),
       <xref linkend="xorg7-font"/> (for tests), and
-      <ulink url="&gi-docgen-url;">gi-docgen</ulink> (for documentation)
     </para>
 
@@ -154 +154 @@
     </para>
 
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-      href="../../xincludes/gtk-doc-rebuild.xml"/>
+    <para>
+      <option>--disable-gtk-doc</option>: This switch prevents building
+      the API documentation, even if <xref linkend="gi-docgen"/> (despite
+      the name of the option) is available.
+    </para>
 
   </sect2>