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

[Glen Barber]

Author: gjb
Date: Thu Mar 12 01:23:06 2015
New Revision: 46336
URL: https://svnweb.freebsd.org/changeset/doc/46336

Log:
  Fix a few grammatical nits.
  Change wording referencing the previous section of the
  kerneldebug book.
  Reword the 'Add these options' sentence.
  Consistify spacing in the KERNCONF addition list.
  Fix a typo.
  
  Sponsored by:	The FreeBSD Foundation

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	Wed Mar 11 12:55:55 2015	(r46335)
+++ head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml	Thu Mar 12 01:23:06 2015	(r46336)
@@ -744,26 +744,29 @@ Debugger (msg=0xf01b0383 "Boot flags req
   <sect1 xml:id="kerneldebug-deadlocks">
     <title>Debugging Deadlocks</title>
 
-    <para>You may experience so called deadlocks, the situation where
+    <para>You may experience so called deadlocks, a situation where
       a system stops doing useful work. To provide a helpful bug report
-      in this situation, use &man.ddb.4; as described above.
+      in this situation, use &man.ddb.4; as described in the previous
+      section.
       Include the output of <command>ps</command> and
       <command>trace</command> for suspected processes in the
       report.</para>
 
-    <para>If possible, consider doing further investigation. The receipt
+    <para>If possible, consider doing further investigation. The recipe
       below is especially useful if you suspect that a deadlock occurs in the
-      VFS layer. Add the following options
-      <programlisting>makeoptions		DEBUG=-g
-	options		INVARIANTS
-	options		INVARIANT_SUPPORT
-	options		WITNESS
-	options		WITNESS_SKIPSPIN
-	options		DEBUG_LOCKS
-	options		DEBUG_VFS_LOCKS
-	options		DIAGNOSTIC</programlisting>
+      VFS layer. Add these options to the kernel configuration
+      file.</para>
 
-      to the kernel configuration file. When a deadlock occurs, in addition to the
+    <programlisting>makeoptions 	DEBUG=-g
+options 	INVARIANTS
+options 	INVARIANT_SUPPORT
+options 	WITNESS
+options 	WITNESS_SKIPSPIN
+options 	DEBUG_LOCKS
+options 	DEBUG_VFS_LOCKS
+options 	DIAGNOSTIC</programlisting>
+
+    <para>When a deadlock occurs, in addition to the
       output of the <command>ps</command> command, provide information
       from the <command>show pcpu</command>, <command>show allpcpu</command>,
       <command>show locks</command>, <command>show alllocks</command>,