some haddock fixes
updates to the manual (from ross):
  make copyright, maintainer and synopsis optional again.
  document required fields, plus a few assorted tweaks.