It turns out that it is not just these tests in 'ext/Pod-Html/t/' which violate the documentation in Pod::Html. The Perl 5 core distribution program 'installhtml' also assigns to *both* 'htmlroot' and 'htmldir'. Here is the relevant code from that program in blead: ########## 548 # runpod2html - invokes pod2html to convert a .pod or .pm file to a .html 549 # file. 550 # 551 sub runpod2html { 552 my($pod, $doindex) = @_; ... 569 # invoke pod2html 570 print "$podroot/$pod => $htmldir/$html\n" if $verbose; 571 Pod::Html::pod2html( 572 "--htmldir=$htmldir", 573 "--htmlroot=$htmlroot", 574 "--podpath=".join(":", @podpath), 575 "--podroot=$podroot", 576 "--header", 577 ($doindex ? "--index" : "--noindex"), 578 "--" . ($recurse ? "" : "no") . "recurse", 579 "--infile=$podroot/$pod", "--outfile=$htmldir/$html"); ########## I would guess that 'installhtml' is the real-world program most likely to use Pod::Html::pod2html(). If that program is using Pod::Html in contradiction to that function's own documentation, then it is not surprising that people experience problems installing HTML versions of POD. Thank you very much. Jim Keenan --- via perlbug: queue: perl5 status: new https://rt.perl.org:443/rt3/Ticket/Display.html?id=114028