- new help texts by AM Desmottes (lebarhon)

- typo fixes by Umeaboy and MrsB

1 files changed, 47 insertions, 21 deletions

diff --git a/docs/mcc-help/en/lspcidrake.xml b/docs/mcc-help/en/lspcidrake.xml
index 34a9353f..3dd9e999 100644
--- a/docs/mcc-help/en/lspcidrake.xml
+++ b/docs/mcc-help/en/lspcidrake.xml
@@ -1,26 +1,52 @@
-<?xml version='1.0' encoding='utf-8'?><section
-xmlns="http://docbook.org/ns/docbook"
-xmlns:ns5="http://www.w3.org/1998/Math/MathML"
-xmlns:ns4="http://www.w3.org/2000/svg"
-xmlns:ns3="http://www.w3.org/1999/xhtml"
-xmlns:ns2="http://www.w3.org/1999/xlink"
-xmlns:ns="http://docbook.org/ns/docbook"
-xml:id="lspcidrake" version="5.0">
+<?xml version='1.0' encoding='utf-8'?><section xmlns="http://docbook.org/ns/docbook" xmlns:ns5="http://www.w3.org/1998/Math/MathML" xmlns:ns4="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:ns2="http://www.w3.org/1999/xlink" xmlns:ns="http://docbook.org/ns/docbook" version="5.0" xml:id="lspcidrake">
   <info>
-	  <title xml:id="lspcidrake-ti1">Display Your PCI Information</title>
-	  <subtitle>lspcidrake</subtitle>
+    <title xml:id="lspcidrake-ti1">Display Your PCI, USB and PCMCIA
+    Information</title>
+
+    <subtitle>lspcidrake</subtitle>
   </info>
 
-  <para>This tool
-    <footnote>
-      <para>You can start this tool from the command line, by typing <emphasis 
-		      role="bold">lspcidrake</emphasis>.
-      </para>
-    </footnote> can only be started and used on the command line.</para>
+  <para>This tool <footnote>
+      <para>You can start this tool from the command line, by typing <emphasis role="bold">lspcidrake</emphasis>.</para>
+    </footnote> can only be started and used on the command line. It will give
+  some more information if used under root.</para>
+
+  <para>lspcidrake gives the list of all the connected devices to the computer
+  (USB, PCI and PCMCIA) and the used drivers. It needs the ldetect and
+  ldetect-lst packages to work.</para>
+
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="lspcidrake1.png" contentwidth="902"/>
+    </imageobject>
+  </mediaobject>
+
+  <para>With the -v option, lspcidrake adds the vendor and device
+  identifications.</para>
+
+  <para>lspcidrake often generates very long lists, so, to find an
+  information, it is often used in a pipeline with the grep command, like in
+  these examples:</para>
+
+  <para>Information about the graphic card;</para>
+
+  <para><command>lspcidrake | grep VGA</command></para>
+
+  <para>Information about the network</para>
+
+  <para><command>lspcidrake | grep -i network</command></para>
+
+  <para>-i to ignore case distinctions.</para>
+
+  <para>In this screenshot below, you can see the action of the -v option for
+  lspcidrake and the -i option for grep.</para>
 
-  <para>This page hasn't been written yet for lack of resources. If you think 
-	you can write this help, please contact 
-	<link ns2:href="https://wiki.mageia.org/en/Documentation_team"> the 
-	       Documentation team.</link> Thanking you in advance.</para>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="lspcidrake2.png" contentwidth="757"/>
+    </imageobject>
+  </mediaobject>
 
-</section>
+  <para>There is another tool that gives information about the hardware, it is
+  called <emphasis role="bold">dmidecode</emphasis> (under root)</para>
+</section>
\ No newline at end of file