Howdy,

I got a *bunch* of stuff done this past week, but not everything I wanted
to.

Things I got done:

- implement different warning levels in Pod::Checker (P::C, for shorthand)
- test P::C's interface (e.g., $pc->node())
- update P::C's documentation to reflect reworded, added, and deleted checks
- test the podchecker cli
- ask pod-people their opinion on particular error checks*
- submit small bug in Pod::Escapes (used to resolve E<> fcodes) to rt
- document 'fake-closer' attribute passed to end_event_handlers if
Pod::Simple (P::S) did not find a real closing directive (e.g., "=end")**
- implement, document, and test 'whiteline_handler' P::S attribute, which
takes a subroutine to handle POD lines that have only whitespace on them***
- add a TODO to P::S::Blackbox to correct E<> resolution based on the
current =encoding
- fix a bug in P::S inhibiting =begin blocks in =over blocks
- send pull requests for all my edits to Pod::Simple and friends

* - I ended up not implementing the error check "argumentless =item", as I
do not think anyone thought it was necessary, and I ended up switching the
error check "=itemless =over/=back block" for "empty =over/=back block", as
the former is not an error.

** - The 'fake-closer' attribute allowed me to implement the error check "no
closing directive for =begin/=over", as Pod::Simple automatically closes
unclosed blocks before triggering the appropriate event so I needed more
information to know if there was in fact a closing directive.

*** - 'whiteline_handler' allowed me to implement the error check
"whitespace on seemingly blank line"

Things I did not get done:

- make P::C its own dist (away from Pod::Parser)
- go over all 'XXX's in Pod::Checker to see if I can remedy the TODOs
- double check that the new Pod::Checker is as good or better than the old,
error checking wise (this will be time consuming)
- document what needs to be done for another module I wanted to convert this
summer, Pod::Usage

The four items above are what I want to get done this next and final week.
rjbs offered to help me with the minor stuff, like removing the 5.14isms I
have been erroneously using, and I am very thankful for that.

Regarding Pod::Html: once all my pull requests for Pod::Simple are accepted
(I need to fixup a few things in two of them) and the module is released and
merged into blead, we can merge Pod::Html into blead and await tests and
complaints.

Thanks,
Marc

Reply via email to