Changeset ac38e9dc for general/sysutils/usbutils.xml

Timestamp:

08/01/2015 04:26:22 AM (9 years ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

systemd-13485

Children:

ad6910d

Parents:

4a83293

Message:

Import back into SVN from Github

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16309 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• general/sysutils/usbutils.xml (modified) (10 diffs)

general/sysutils/usbutils.xml

@@ -7 +7 @@
   <!ENTITY usbutils-download-http "http://ftp.kernel.org/pub/linux/utils/usb/usbutils/usbutils-&usbutils-version;.tar.xz">
   <!ENTITY usbutils-download-ftp  "ftp://ftp.kernel.org/pub/linux/utils/usb/usbutils/usbutils-&usbutils-version;.tar.xz">
-  <!ENTITY usbutils-md5sum        "c9df5107ae9d26b10a1736a261250139">
-  <!ENTITY usbutils-size          "416 KB">
-  <!ENTITY usbutils-buildsize     "4.8 MB">
+  <!ENTITY usbutils-md5sum        "2780b6ae21264c888f8f30fb2aab1259">
+  <!ENTITY usbutils-size          "284 KB">
+  <!ENTITY usbutils-buildsize     "3.8 MB">
   <!ENTITY usbutils-time          "less than 0.1 SBU">
 ]>
@@ -31 +31 @@
 
     <para>
-      The <application>USB Utils</application> package contains an utility
+      The <application>USB Utils</application> package contains utilities
       used to display information about USB buses in the system and the
       devices connected to them.
     </para>
 
-    &lfs76_checked;
+    &lfs77_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
@@ -79 +79 @@
     </para>
 
+    <bridgehead renderas="sect4">Required Runtime</bridgehead>
+    <para role="required runtime">
+      <xref linkend="python2"/>    </para>
+
     <para condition="html" role="usernotes">User Notes:
       <ulink url="&blfs-wiki;/usbutils"/>
@@ -92 +96 @@
     </para>
 
-<screen><userinput>sed -i '/^usbids/ s:usb.ids:hwdata/&amp;:' lsusb.py &amp;&amp;
-
-./configure --prefix=/usr --datadir=/usr/share/hwdata &amp;&amp;
+<screen><userinput>sed -i '/^usbids/ s:usb.ids:misc/&amp;:' lsusb.py &amp;&amp;
+
+./configure --prefix=/usr --datadir=/usr/share/misc &amp;&amp;
 make</userinput></screen>
 
@@ -105 +109 @@
     </para>
 
-<screen role="root"><userinput>make install &amp;&amp;
-mv -v /usr/sbin/update-usbids.sh /usr/sbin/update-usbids</userinput></screen>
+<screen role="root"><userinput>make install</userinput></screen>
+
+    <para>
+      The script <command>lsusb.py</command> displays information in a more
+      easily readable form than <command>lsusb</command>. To find the options,
+      use <command>lsusb.py -h</command>. One form of use recommended by the
+      developer is <command>lsusb.py -ciu</command>.
+    </para>
 
   </sect2>
@@ -114 +124 @@
 
     <para>
-      <option>--disable-zlib</option>: This stops
-      <application>USB Utils</application> from installing a
-      compressed <filename>usb.ids</filename>  alongside the
-      uncompressed one.
+      <command>sed ... lsusb.py</command>: Instructs lsusb.py where to search
+      <filename>usb.ids</filename>.
     </para>
 
@@ -126 +134 @@
 
     <para>
-      The <filename>usb.ids</filename> data file is constantly being
-      updated. To get a current version of this file, run, as the <systemitem
-      class="username">root</systemitem> user:</para>
-
-<screen role="root"><userinput>install -dm755 /usr/share/hwdata/ &amp;&amp;
-wget http://www.linux-usb.org/usb.ids -O /usr/share/hwdata/usb.ids</userinput></screen>
+      The <filename>usb.ids</filename> data file is constantly being updated.
+      To get a current version of this file, using <xref linkend="wget"/>, run,
+      as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>wget http://www.linux-usb.org/usb.ids -O /usr/share/misc/usb.ids</userinput></screen>
 
     <para>
       You may wish to add an entry to
       <systemitem class="username">root</systemitem>'s (or any other user who has
-      write privilege to <filename class="directory">/usr/share/hwdata</filename>)
+      write privilege to <filename class="directory">/usr/share/misc</filename>)
       crontab to automatically update the <filename>usb.ids</filename> file
       periodically.
@@ -153 +160 @@
       <seglistitem>
         <seg>
-          lsusb, update-usbids, usb-devices, and usbhid-dump
+          lsusb, lsusb.py, usb-devices, and usbhid-dump
         </seg>
         <seg>
@@ -174 +181 @@
           <para>
             is an utility for displaying information about all USB buses
-            in the system and all devices connected to them.
+            in the system and all devices connected to them, but not in human
+            friendly form.
           </para>
           <indexterm zone="usbutils lsusb">
@@ -182 +190 @@
       </varlistentry>
 
-      <varlistentry id="update-usbids">
-        <term><command>update-usbids</command></term>
-        <listitem>
-          <para>
-            downloads the current version of the USB ID list. Requires
-            <xref linkend="lynx"/> or <xref linkend="wget"/>.
-          </para>
-          <indexterm zone="usbutils update-usbids">
-            <primary sortas="b-update-usbids">update-usbids</primary>
+      <varlistentry id="lsusb.py">
+        <term><command>lsusb.py</command></term>
+        <listitem>
+          <para>
+            displays information about all USB buses in the system and all
+            devices connected to them in reasonable human friendly form.
+          </para>
+          <indexterm zone="usbutils lsusb.py">
+            <primary sortas="b-lsusb.py">lsusb.py</primary>
           </indexterm>
         </listitem>