Add massive new docs from Peter Mount.

Includes markup for the introductory portions suitable for the User's Guide
 but just put the class reference material inside a huge <programlisting>
 block. Figure out what to do later...

Author: Thomas G. Lockhart