GSoC Status Update

[email protected] (Marc Green)
Newsgroups perl.pod-people
Message-ID <[email protected]>
Hello everyone,

I am nearly finished converting Pod::Html to use Pod::Simple, which produces
a great feeling, especially compared to the initial overwhelmed feeling I
had before trekking through this module.

Over the past week I have accomplished several goals, including:
implementing a --recurse flag for Pod::Simple::Search to enable/disable
recursing through directories (enabled by default), which is needed because
Pod::Html offers the same flag; implementing a flag in Pod::Simple::Xhtml to
anchor certain =item directives (certain meaning the type of =item that is a
definition list, not a bulleted or numbered list), which is needed in order
to link to those =item directives; and completing several test cases (and
fixing bugs revealed by said test cases).

To call this module finished, I need to complete one final test case, fix up
a few others (explained below), and implement a switch in Pod::Html to
disable the POD ERRORS section from appearing in converted pod files (in
case some don't want that section).

The meeting I had with my mentors today is pushed to
https://github.com/rjbs/TPF-GSoC-Pod/ if you want to read what transpired. A
main point was that I need to modify the test cases that rely on
/usr/share/perl being present. When making them I knew I would need to
handle this issue, but I figured I would just skip those tests. I was
persuaded to instead just make a mock /usr/share/perl in the test directory
to keep the test cases self sustaining. That seems like the obvious thing to
do, oh well.

If I can finish Pod::Html by Wednesday then I will be right on track with my
projected timeline. I have been working on Pod::Html for a whopping five and
a half weeks. In my proposal I naively gave myself 2.5 weeks to do
Pod::Html, and I clearly did not understand the complexity of the task.
However, because I started writing code at the start of the community
bonding period instead of the official coding period, I gained several
weeks, balancing out my work and the timeline.

Assuming I finish Pod::Html, I will start on Pod::Checker this week.

Thank you,
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.