New help file

2 files changed, 88 insertions, 4 deletions

diff --git a/docs/mcc-help/en/drakbug_report.xml b/docs/mcc-help/en/drakbug_report.xml
new file mode 100644
index 00000000..e4fc98aa
--- /dev/null
+++ b/docs/mcc-help/en/drakbug_report.xml
@@ -0,0 +1,74 @@
+<?xml version='1.0' encoding='utf-8'?><section
+xmlns="http://docbook.org/ns/docbook"
+xmlns:xlink="http://www.w3.org/1999/xlink"
+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:ns="http://docbook.org/ns/docbook"
+xml:id="drakbug_report" version="5.0">
+
+  <info>
+	  <title xml:id="drakbug_report-ti1">Collect Logs and System Information 
+		  for Bug Reports</title><subtitle>drakbug_report</subtitle>
+  </info>
+
+  <para>This tool<footnote><para>You can start this tool from the command 
+	line, by typing <emphasis role="bold">drakbug_report</emphasis> as 
+	root.</para></footnote> can only be started and used on the command 
+	line.</para>
+
+<para>It is advised to write the output of this command to a file, for 
+	instance by doing <emphasis role="bold">drakbug_report > 
+	drakbugreport.txt</emphasis>, but make sure you have enough disk space 
+	first: the file can easily be several GBs large.</para>
+<note><para>The output is far too large to attach to a bug report without 
+first removing the unneeded parts.</para></note>
+  <para>This command collects the following information on your system:</para>
+
+  <itemizedlist>
+	  <listitem><para> lspci</para></listitem>
+	  <listitem><para> pci_devices</para></listitem>
+	  <listitem><para> dmidecode</para></listitem>
+	  <listitem><para> fdisk</para></listitem>
+	  <listitem><para> scsi</para></listitem>
+	  <listitem><para> /sys/bus/scsi/devices</para></listitem>
+	  <listitem><para> lsmod</para></listitem>
+	  <listitem><para> cmdline</para></listitem>
+	  <listitem><para> pcmcia: stab</para></listitem>
+	  <listitem><para> usb</para></listitem>
+	  <listitem><para> partitions</para></listitem>
+	  <listitem><para> cpuinfo</para></listitem>
+	  <listitem><para> syslog</para></listitem>
+	  <listitem><para> Xorg.log</para></listitem>
+	  <listitem><para> monitor_full_edid</para></listitem>
+	  <listitem><para> stage1.log</para></listitem>
+	  <listitem><para> ddebug.log</para></listitem>
+	  <listitem><para> install.log</para></listitem>
+	  <listitem><para> fstab</para></listitem>
+	  <listitem><para> modprobe.conf</para></listitem>
+	  <listitem><para> lilo.conf</para></listitem>
+	  <listitem><para> grub: menu.lst</para></listitem>
+	  <listitem><para> grub: install.sh</para></listitem>
+	  <listitem><para> grub: device.map</para></listitem>
+	  <listitem><para> xorg.conf</para></listitem>
+	  <listitem><para> urpmi.cfg</para></listitem>
+	  <listitem><para> modprobe.preload</para></listitem>
+	  <listitem><para> sysconfig/i18n</para></listitem>
+	  <listitem><para> /proc/iomem</para></listitem>
+	  <listitem><para> /proc/ioport</para></listitem>
+	  <listitem><para> mageia version</para></listitem>
+	  <listitem><para> rpm -qa</para></listitem>
+	  <listitem><para> df</para></listitem>
+  </itemizedlist>
+
+
+  <note><para>At the time this help page was written, the "syslog" part of 
+	this command's output was empty, because this tool had not yet been 
+	adjusted to our switch to systemd. If it is still empty, you can 
+	retrieve the "syslog" by doing (as root) <emphasis role="bold">
+	journalctl -a > journalctl.txt</emphasis>. If you don't have a lot of 
+	diskspace, you can, for instance, take the last 5000 lines of the log 
+	instead with: <emphasis role="bold">journalctl -a | tail -n5000 > 
+	journalctl5000.txt</emphasis>.</para></note>
+  
+</section>
diff --git a/docs/mcc-help/en/otherMageiaTools.xml b/docs/mcc-help/en/otherMageiaTools.xml
index 5b9c850b..a8c4dbba 100644
--- a/docs/mcc-help/en/otherMageiaTools.xml
+++ b/docs/mcc-help/en/otherMageiaTools.xml
@@ -8,23 +8,33 @@
 
       <orderedlist>
         <listitem>
-          <para><xref linkend="drakbug"/></para>
+		<para><xref linkend="drakbug"/><emphasis>drakbug</emphasis>
+		</para>
         </listitem>
 
+	<listitem>
+		<para><xref linkend="drakbug_report"/><emphasis>drakbug_report
+		</emphasis></para>
+	</listitem>
+
         <listitem>
-		<para><xref linkend="lsnetdrake"/><emphasis>TO BE WRITTEN</emphasis></para>
+		<para><xref linkend="lsnetdrake"/><emphasis>TO BE WRITTEN
+		</emphasis></para>
         </listitem>
         <listitem>
-          <para><xref linkend="lspcidrake"/><emphasis>TO BE WRITTEN</emphasis></para>
+		<para><xref linkend="lspcidrake"/><emphasis>TO BE WRITTEN
+		</emphasis></para>
         </listitem>
 
         <listitem>
-          <para>And more tools?</para>
+        	<para>And more tools?</para>
         </listitem>
       </orderedlist>
 
 	<xi:include href="drakbug.xml"></xi:include>
 
+	<xi:include href="drakbug_report.xml"></xi:include>
+
 	<xi:include href="lsnetdrake.xml"></xi:include>
 
         <xi:include href="lspcidrake.xml"></xi:include>