svn commit: r48734 - head/en_US.ISO8859-1/books/developers-handbook/kerneldebug

[Benedict Reuschling]

Author: bcr
Date: Sun Apr 24 21:23:28 2016
New Revision: 48734
URL: https://svnweb.freebsd.org/changeset/doc/48734

Log:
  Rewrite my previous change to use a <variablelist>.  That way, it is much
  clearer to understand and easier to read than having it all in one long
  sentence.
  
  Suggested by:	wblock@
  Sponsored by:	Essen Hackathon 2016

Modified:
  head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml

Modified: head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml	Sun Apr 24 21:10:15 2016	(r48733)
+++ head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml	Sun Apr 24 21:23:28 2016	(r48734)
@@ -43,15 +43,40 @@
       <quote>swap device</quote> is synonymous with a <quote>swap
       partition.</quote></para></note>
 
-    <para>Several types of kernel crash dumps are available: full memory
-      dumps, which hold the complete contents of physical memory;
-      minidumps, which hold only memory pages in use by the kernel
-      (&os;  6.2 and higher); and textdumps, which hold captured
-      scripted or interactive debugger output (&os; 7.1 and higher).
-      Minidumps are the default dump type as of &os; 7.0, and in most
-      cases will capture all necessary information present in a full
-      memory dump, as most problems can be isolated only using kernel
-      state.</para>
+    <para>Several types of kernel crash dumps are available:</para>
+      <variablelist>
+	<varlistentry>
+	  <term>Full memory dumps</term>
+
+	  <listitem>
+	    <para>Hold the complete contents of physical
+	      memory.</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term>Minidumps</term>
+
+	  <listitem>
+	    <para>Hold only memory pages in use by the kernel
+	      (&os; 6.2 and higher).</para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term>Textdumps</term>
+
+	  <listitem>
+	    <para>Hold captured, scripted, or interactive debugger
+	      output (&os; 7.1 and higher).</para>
+	  </listitem>
+	</varlistentry>
+      </variablelist>
+
+      <para>Minidumps are the default dump type as of &os; 7.0,
+	and in most cases will capture all necessary information
+	present in a full memory dump, as most problems can be
+	isolated only using kernel state.</para>
 
     <sect2 xml:id="config-dumpdev">
       <title>Configuring the Dump Device</title>