summaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook
diff options
context:
space:
mode:
authorJeff Garzik <jgarzik@pobox.com>2005-09-28 19:26:47 +0200
committerJeff Garzik <jgarzik@pobox.com>2005-09-28 19:26:47 +0200
commita1213499b0ef75d8c627b461047805a235c9dd00 (patch)
tree89b39cb950138db7c2f9d65b1abe14e8993e3bc1 /Documentation/DocBook
parent[PATCH] libata EH document update (diff)
downloadlinux-a1213499b0ef75d8c627b461047805a235c9dd00.tar.xz
linux-a1213499b0ef75d8c627b461047805a235c9dd00.zip
libata: move EH docs to separate DocBook chapter
Diffstat (limited to 'Documentation/DocBook')
-rw-r--r--Documentation/DocBook/libata.tmpl30
1 files changed, 15 insertions, 15 deletions
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">