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
