Parser warnings; especially for invalid doc comments

This patch adds:

 * A facility for non-fatal parser warnings
 * A convenient way to add specific warnings for invalid documentation
   comments
 * Warnings for module doc comments (which are not currently supported)
Merge pull request #921 from david-christiansen/parse-doc-comment-warnings

Parser warnings; especially for invalid doc comments