[DOCS] POD Errors

[Michael Scott]

For those of you who like perusing gobs of autogenerated info, take a 
look at

	http://homepage.mac.com/michael_scott/Parrot/pod_report.html

where I've put up a list of Parrot POD errors as seen by podchecker.

I've started to put together a bunch Perl modules which will allow us 
autogenerate HTML documentation from the inline POD. As a step in this 
direction, unless anyone has objections, I'm going to tidy up the POD. 
I'll do this a file at a time, and let you know when it's done.

Mike