G'day haj,

++ Many thanks for your reply.

"Unfortunately, pod2html does not work like this. ..."

I think that explains my earlier statement: "I feel like I'm missing something obvious, but have no idea what that might be."

I didn't realise that I needed --verbose to display warning messages. I did try it and sure enough:

...
Cannot find file "perlpod.*" directly under podpath, cannot find suita
+ble replacement: link remains unresolved.
Cannot find file "strict.*" directly under podpath, cannot find suitab
+le replacement: link remains unresolved.
Cannot find file "Getopt/Long.*" directly under podpath, cannot find s
+uitable replacement: link remains unresolved.
Cannot find file "Text/CSV.*" directly under podpath, cannot find suit
+able replacement: link remains unresolved.
[download]

Based on that, I tried adding '--podpath=`perl -e 'print join ":", @INC'` --recurse'. This did produce links with href= values like "/path/to/name.html"; however, none of those name.html files existed — there were equivalent name.pod or name.pm files at the /path/to/ locations.

That may be worth pursuing, or perhaps your suggestion of "hook into sub resolve_pod_page_link" would be a better option. Anyway, that's got me further along than I was before, so thanks again.