r5436 - trunk/BOOK/general/genlib

randy at linuxfromscratch.org randy at linuxfromscratch.org
Fri Dec 16 09:18:13 PST 2005


Author: randy
Date: 2005-12-16 10:18:12 -0700 (Fri, 16 Dec 2005)
New Revision: 5436

Modified:
   trunk/BOOK/general/genlib/libusb.xml
Log:
Added an FTP download URL, a note about running the test suite and additional explanatory text to the libusb instructions

Modified: trunk/BOOK/general/genlib/libusb.xml
===================================================================
--- trunk/BOOK/general/genlib/libusb.xml	2005-12-16 15:50:53 UTC (rev 5435)
+++ trunk/BOOK/general/genlib/libusb.xml	2005-12-16 17:18:12 UTC (rev 5436)
@@ -5,11 +5,11 @@
   %general-entities;
 
   <!ENTITY libusb-download-http "http://prdownloads.sourceforge.net/libusb/libusb-&libusb-version;.tar.gz">
-  <!ENTITY libusb-download-ftp " ">
-  <!ENTITY libusb-md5sum "c6062b29acd2cef414bcc34e0decbdd1">
-  <!ENTITY libusb-size "375 KB">
-  <!ENTITY libusb-buildsize "7.4 MB (additional 1.3 MB to install documentation)">
-  <!ENTITY libusb-time "0.1 SBU">
+  <!ENTITY libusb-download-ftp  "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/libusb-&libusb-version;.tar.gz">
+  <!ENTITY libusb-md5sum        "c6062b29acd2cef414bcc34e0decbdd1">
+  <!ENTITY libusb-size          "375 KB">
+  <!ENTITY libusb-buildsize     "7.4 MB (additional 1.3 MB to install documentation)">
+  <!ENTITY libusb-time          "0.1 SBU">
 ]>
 
 <sect1 id="libusb" xreflabel="libusb-&libusb-version;">
@@ -24,14 +24,14 @@
     </keywordset>
   </sect1info>
 
-  <title>Libusb-&libusb-version;</title>
+  <title>libusb-&libusb-version;</title>
 
   <indexterm zone="libusb">
     <primary sortas="a-Libusb">Libusb</primary>
   </indexterm>
 
   <sect2 role="package">
-    <title>Introduction to Libusb</title>
+    <title>Introduction to libusb</title>
 
     <para>The <application>libusb</application> package contains a library
     used by some applications for USB device access.</para>
@@ -58,7 +58,7 @@
       </listitem>
     </itemizedlist>
 
-    <bridgehead renderas="sect3">Libusb Dependencies</bridgehead>
+    <bridgehead renderas="sect3">libusb Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Optional (Required to Build the HTML User
     Manual)</bridgehead>
@@ -74,7 +74,7 @@
   </sect2>
 
   <sect2 role="installation">
-    <title>Installation of Libusb</title>
+    <title>Installation of libusb</title>
 
     <para>Install <application>libusb</application> by running the following
     commands:</para>
@@ -82,23 +82,28 @@
 <screen><userinput>./configure --prefix=/usr --disable-build-docs &&
 make</userinput></screen>
 
-    <para>If you wish to build the API documentation, issue
-    the following command:</para>
+    <para>If you wish to build the API documentation (see the required
+    dependencies), issue the following command:</para>
 
 <screen><userinput>make apidox</userinput></screen>
 
+    <para>To test the results, issue <command>make -k check</command>.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-    <para>If you built the HTML user manual, install it using the following commands
-    as the <systemitem class="username">root</systemitem> user:</para>
+    <para>If you built the HTML user manual (by having the required
+    dependencies installed and removing the
+    <parameter>--disable-build-docs</parameter> parameter from the
+    <command>configure</command> command), install it using the following
+    commands as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>install -v -d -m755 /usr/share/doc/libusb-&libusb-version;/html &&
 install -v -m644 doc/html/* /usr/share/doc/libusb-&libusb-version;/html</userinput></screen>
 
-    <para>If you built the API documentation, install it using the following commands
-    as the <systemitem class="username">root</systemitem> user:</para>
+    <para>If you built the API documentation, install it using the following
+    commands as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>install -v -d -m755 /usr/share/doc/libusb-&libusb-version;/apidocs &&
 install -v -m644 apidocs/html/* \
@@ -109,23 +114,9 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><parameter>--disable-build-docs</parameter>: This switch avoids building the
-    HTML user manual.</para>
+    <para><parameter>--disable-build-docs</parameter>: This switch avoids
+    building the HTML user manual.</para>
 
-<!-- Disabling obsolete text
-
-    If you wish to build the user manual, you
-    may need to remove the <application>OpenSP</application> catalog definitions
-    from the system SGML catalogs. Use the following command
-    before building the package to accomplish this:</para>
-
-<screen role='root'><userinput>sed -i.orig \
-    -e "/CATALOG \/etc\/sgml\/OpenSP-1.5.1.cat/d" \
-    /etc/sgml/catalog \
-    /etc/sgml/sgml-docbook.cat</userinput></screen>
-
--->
-
   </sect2>
 
   <sect2 role="configuration">




More information about the blfs-book mailing list