From: Jeff Garzik <jgarzik@pobox.com>
Date: Wed, 28 Sep 2005 17:26:47 +0000 (-0400)
Subject: libata: move EH docs to separate DocBook chapter
X-Git-Url: http://git.lede-project.org./?a=commitdiff_plain;h=a1213499b0ef75d8c627b461047805a235c9dd00;p=openwrt%2Fstaging%2Fblogic.git

libata: move EH docs to separate DocBook chapter
---

diff --git a/Documentation/DocBook/libata.tmpl b/Documentation/DocBook/libata.tmpl
index fcbb58fc0fee..b2ec780bcda1 100644
--- a/Documentation/DocBook/libata.tmpl
+++ b/Documentation/DocBook/libata.tmpl
@@ -413,7 +413,9 @@ and other resources, etc.
 	</sect2>
 
      </sect1>
-     <sect1>
+  </chapter>
+
+  <chapter id="libataEH">
         <title>Error handling</title>
 
 	<para>
@@ -422,7 +424,7 @@ and other resources, etc.
 	(Documentation/scsi/scsi_eh.txt) and ATA exceptions doc first.
 	</para>
 
-	<sect2><title>Origins of commands</title>
+	<sect1><title>Origins of commands</title>
 	<para>
 	In libata, a command is represented with struct ata_queued_cmd
 	or qc.  qc's are preallocated during port initialization and
@@ -437,9 +439,9 @@ and other resources, etc.
 	and commands for SCSI emulation are passed as SCSI commands
 	through queuecommand callback of SCSI host template.
 	</para>
-	</sect2>
+	</sect1>
 
-	<sect2><title>How commands are issued</title>
+	<sect1><title>How commands are issued</title>
 
 	<variablelist>
 
@@ -501,9 +503,9 @@ and other resources, etc.
 	</varlistentry>
 
 	</variablelist>
-	</sect2>
+	</sect1>
 
-	<sect2><title>How commands are processed</title>
+	<sect1><title>How commands are processed</title>
 	<para>
 	Depending on which protocol and which controller are used,
 	commands are processed differently.  For the purpose of
@@ -562,9 +564,9 @@ and other resources, etc.
 	   </listitem>
 	   </varlistentry>
 	</variablelist>
-        </sect2>
+        </sect1>
 
-	<sect2><title>How commands are completed</title>
+	<sect1><title>How commands are completed</title>
 	<para>
 	Once issued, all qc's are either completed with
 	ata_qc_complete() or time out.  For commands which are handled
@@ -660,9 +662,9 @@ and other resources, etc.
 	This leads us to ata_scsi_error() with partially completed qc.
 	</para>
 
-	</sect2>
+	</sect1>
 
-	<sect2><title>ata_scsi_error()</title>
+	<sect1><title>ata_scsi_error()</title>
 	<para>
 	ata_scsi_error() is the current hostt->eh_strategy_handler()
 	for libata.  As discussed above, this will be entered in two
@@ -697,9 +699,9 @@ and other resources, etc.
 	to/cannot call ata_qc_complete() again.
 	</para>
 
-	</sect2>
+	</sect1>
 
-	<sect2><title>Problems with the current EH</title>
+	<sect1><title>Problems with the current EH</title>
 
 	<itemizedlist>
 
@@ -766,9 +768,7 @@ and other resources, etc.
 	</listitem>
 
 	</itemizedlist>
-	</sect2>
-
-     </sect1>
+	</sect1>
   </chapter>
 
   <chapter id="libataExt">