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 &amp;&amp;
 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 &amp;&amp;
 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 &amp;&amp;
 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">

-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to