Changeset 048071e

Timestamp:

01/30/2023 04:16:38 AM (15 months ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

11.3, 12.0, 12.1, 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/llvm18, xry111/xf86-video-removal

Children:

bb3c618

Parents:

dbdd6ff4

Message:

gobject-introspection: Tweaks regarding gi-doc-tool.

Add Markdown as an optional dependency since gi-doc-tool needs it

Clarify text and comments regarding gi-doc-tool

File:

• general/genlib/gobject-introspection.xml (modified) (5 diffs)

general/genlib/gobject-introspection.xml

@@ -80 +80 @@
       <xref linkend="cairo"/> (required for the tests),
       <xref linkend="gjs"/> (to satisfy one test),
-      <xref linkend="gtk-doc"/>, and
-      <xref linkend="Mako"/>
+      <xref linkend="gtk-doc"/>,
+      <xref linkend="Mako"/>, and
+      <xref linkend="markdown"/>
       <!--<ulink url="https://pypi.org/project/Markdown/">Markdown</ulink> (to satisfy one test)-->
       <!-- There was talk of this being required in the release notes. Can someone
@@ -87 +88 @@
       It is only needed for one test.  bdubbs March 3, 2019
       I do not have Markdown and all tests pass for 1.74.0.  Sep 2022
+      More investigation notes that Markdown and Mako are needed for gi-doc-tool.
+      January 2023
       -->
     </para>
@@ -111 +114 @@
     <para>
       To test the results, issue: <command>ninja test</command>.
-      <!--
-      If <xref linkend="Mako"/> is installed but the Python 3 module named
-      Markdown (not in BLFS) is not, one test named test_docwriter.py will
-      fail.-->
     </para>
 
@@ -142 +141 @@
     <para>
       <option>-Ddoctool=enabled</option>: Install g-ir-doc-tool
-      and run related tests.
+      and run related tests. You must have
+      <xref linkend="Mako" role="nodep"/> and
+      <xref linkend="markdown" role="nodep"/> installed in order
+      to install this utility.
     </para>
 
@@ -155 +157 @@
       <segtitle>Installed Directories</segtitle>
 
-      <!-- g-ir-doc-tool is installed if mako is presnet -->
+      <!-- g-ir-doc-tool is installed if Mako and Markdown are present -->
       <seglistitem>
         <seg>