pod2html --htmlroot=/var/www/html --podroot=. --recurse --verbose --po
+dpath=bin:tests
[download]

The above command just appears to hang for a really long time, presumably waiting for input.

pod2html --htmlroot=/var/www/html --podroot=. --recurse --verbose --po
+dpath=bin:tests --infile=index.pod --outfile=index.html
[download]

creates just one html file (as expected) and does not chase links to create linked html files (as would be nice). It also creates the tmp files.

bin and tests are subdirectories of '.' and have perl scripts, modules, pod files and other files (sample templates, etc) all with perlpod in them.

P.S. New discovery for me; the first command IS waiting for input. You can type in random perlpod, then ^d breaks you out of it and outputs to stdout.