Documentation tidyup, halt on pod errors.

Moved stray pod function descrpitions into pod section.
Change so that messages only appear with --verbose option. Doc option.
Change install to check for Makefile.PL and Makefile.