Today I did what I do when I have to review some really arduous and involved code: I print it out and go to some near-empty diner and sit there for a long time, reading the code and nibbling at whatever, and sipping iced tea. My record so far is about nine hours I spent in a diner in Grants, New Mexico, going over the old code for HTML::TreeBuilder and endless pages of trace output, trying to figure out why it just wasn't working.
But today it was just an hour or so pondering the code for the new (perlpodspec-compliant) Pod parser, which I hadn't looked at in ages. I did a bit of refactoring, and a bit of rearranging, and clarified the code here and there. I hope I can do an alpha release in two or three weeks, maybe even with a passable amount of documentation.