   To do
          Document the API, and give examples of usage.

   For now, full Doxygen comments are provided at the top of each class
   method.
