Documentation contains many TODOs

[d-lamb]

I'm reading the documentation about POD parsers. The PDL project's current POD parser is written using Pod::Select. The documentation in Pod::Select says that it is legacy as of Perl 5.18 and to suggests using Pod::Simple for all things Pod. That is fine, but there are still many TODOs in the documentation for Pod::Simple, a core module:

• The SYNOPSIS for Pod::Simple contains only a TODO (either it needs to be filled in or eliminated);
• The documentation for Pod::Simple::Subclassing contains 8 TODOs, including at the top of the Events section (this seems like an important section?).

There may be others, but those are the ones I have come across so far.