Re-commit my cleanup changes.
Apparently, igor does not like the occurance of the second <para> in the
<para><note><para> sequence in the abstract. Replacing it with something else
makes the file not pass the DTD checks. Err on the side of letting the file
compile, leaving a couple of igor checks unresolved.

Overall, the docbook xml source in this file should be much cleaner now.