doc: Make micropeak.xsl validate

[fw/altos] / doc / micropeak.xsl

diff --git a/doc/micropeak.xsl b/doc/micropeak.xsl
index 2120acb2942b3a1ee40c8f521703df244abb1056..afa6fd1575fdba714407535d2610c239d5b904ab 100644 (file)
--- a/doc/micropeak.xsl
+++ b/doc/micropeak.xsl
@@ -55,7 +55,8 @@
       </revision>
     </revhistory>
   </bookinfo>
-  <acknowledgements>
+  <dedication>
+    <title>Acknowledgements</title>
     <para>
       Thanks to John Lyngdal for suggesting that we build something like this.
     </para>
@@ -70,7 +71,7 @@ Keith Packard, KD7SQG
 NAR #88757, TRA #12200
       </literallayout>
     </para>
-  </acknowledgements>
+  </dedication>
   <chapter>
     <title>Quick Start Guide</title>
     <para>
@@ -224,12 +225,17 @@ NAR #88757, TRA #12200
        </listitem>
        <listitem>
          <para>
-           The MicroPeak USB adapter has a small phototransistor on the 
-           end of the board furthest from the USB connector. Locate
-           this and place the LED on the MicroPeak right over
-           it. Turn on the MicroPeak board and adjust the position
-           until the blue LED on the MicroPeak USB adapter blinks in
-           time with the orange LED on the MicroPeak board.
+           The MicroPeak USB adapter has a small phototransistor on
+           the end of the board furthest from the USB
+           connector. Locate this and place the LED on the MicroPeak
+           directly in contact with it. The MicroPeak LED and the
+           MicroPeak USB adapter photo need to be touching—even a
+           millimeters of space between them will reduce the light
+           intensity from the LED enough that the phototransistor
+           will not sense it. Turn on the MicroPeak board and adjust
+           the position until the blue LED on the MicroPeak USB
+           adapter blinks in time with the orange LED on the
+           MicroPeak board.
          </para>
        </listitem>
        <listitem>