Changeset f10c288 for general/genlib/libgusb.xml

Timestamp:

02/20/2018 06:34:45 PM (6 years ago)

Author:

Ken Moffat <ken@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

32e1fadc

Parents:

c1ecca9

Message:

For libgusb promote gtk-doc to recommended, but explain how to avoid it. By default the *install* will fail with FileNotFoundError: [Errno 2] No such file or directory: 'gtkdoc-scan'.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19825 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• general/genlib/libgusb.xml (modified) (3 diffs)

general/genlib/libgusb.xml

@@ -82 +82 @@
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended">
+      <xref linkend="gtk-doc"/>
       <xref linkend="gobject-introspection"/>,
       <xref linkend="usbutils"/> (for <filename>usb.ids</filename> data file,
       which is also required for the tests), and
       <xref linkend="vala"/>
-    </para>
-
-    <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional">
-      <xref linkend="gtk-doc"/>
     </para>
 
@@ -122 +118 @@
 <screen role="root"><userinput>ninja install</userinput></screen>
   </sect2>
-<!--
+
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-      href="../../xincludes/static-libraries.xml"/>
-
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="../../xincludes/gtk-doc-rebuild.xml"/>
+    <para>
+      <option>-Ddocs=false</option>: Add this option if
+      <application>gtk-doc</application> has not been installed.
+    </para>
 
   </sect2>
--->
+
   <sect2 role="content">
     <title>Contents</title>
@@ -151 +146 @@
         <seg>
           /usr/include/gusb-1 and
-          /usr/share/gtk-doc/html/gusb
+          /usr/share/gtk-doc/html/gusb (if gtk-doc is used)
         </seg>
       </seglistitem>