GSoC Status Update

[email protected] (Marc Green)
Newsgroups perl.pod-people
Message-ID <CAAL1P-GZo-38TC=V2S6+YT-ybx8SrtqaD7_hUNC_5PLNHaqhow@mail.gmail.com>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.