Changeset a2b2af3

Timestamp:

08/15/2022 02:22:19 PM (21 months ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

11.2, 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/soup3, xry111/xf86-video-removal

Children:

c241762

Parents:

00fa223

Message:

gdk-pixbuf: Add recommended dependency on docutils.

When trying to build gdk-pixbuf without docutils installed, you will get
the following message:

ERROR: Problem encountered: No rst2man found, but man pages were explicitly enabled

Manual pages are enabled by default (as they should be), so I've added a
recommended dependency on docutils, and then added an option to the
Command Explanations to disable it if users desire.

File:

• x/lib/gdk-pixbuf.xml (modified) (2 diffs)

x/lib/gdk-pixbuf.xml

@@ -88 +88 @@
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended">
+      <xref linkend="docutils"/>,
       <xref role="runtime" linkend="librsvg"/> (runtime dependency, needed for
          loading symbolic icons) and
@@ -158 +159 @@
       href="../../xincludes/meson-wrap-nofallback.xml"/>
 
-    <!-- gtk_doc replaced by gi-docgen
-    <para>
-      <option>-Dgtk_doc=true</option>: Use this parameter if
-      <application>GTK-Doc</application> is installed and you wish to rebuild
-      and install the API documentation.
-      <!\-\- -Dgtk_doc is set to "yield=true" in meson_options.txt \-\->
-    </para>-->
-<!-- Removed in 2.42.0
-    <para>
-      <option>-Djasper=true</option>: If you've installed
-      <xref linkend="jasper"/> and you want
-      <application>Gdk Pixbuf</application> to use it to compile a
-      JPEG2000 image loader, pass this switch to meson.
-    </para>
--->
+    <!-- with 2.42.9, docutils must be installed to generate man pages.
+    Without this, you'll get the following output:
+    Program rst2man found: ../docs/meson.build:70:2: ERROR: Problem encountered:
+    No rst2man found, but man pages were explicitly enabled -->
+    <para>
+      <option>-Dman=false</option>: Use this option if you do not want to
+      generate manual pages, or if you do not want to install
+      <xref linkend="docutils" role="nodep"/>.
+    </para>
+
   </sect2>