Fixed malformed haddock comments

The command:

    $ make doc

now only gives warnings and runs to completion.