I'm no expert on the html::parser::* modules but to get better answers on your post, instead of using

foreach my $doc ( @html_docs ) {
[download]

you would probably be better off posting a script with *input* that results in the problem you're having. I like having the input read in from <DATA>, for example like what I had at Celsius to Fahrenheit using s///

Then the monks don't have to create test input to help you troubleshoot your problem