in reply to Re^3: Reading Perl documentation in Emacs
in thread Reading Perl documentation in Emacs

> then I'd say HTML is the way to go for structured documentation.

Could you please elaborate?

Sure. HTML is powerful enough to express all POD markup. I consider linking to other documents very useful in technical documentation.
woman seems to render much faster than html.
Rendering speed is very low on my priority list.
POD was primarily designed for man, ...
Irrelevant. POD pre-dates HTML. In the 1990s I worked with a 25 lines / 80 (or 132) columns terminal. Back then it wasn't unusual to actually print man pages. Today I read technical documentation almost exclusively online. My requirements are now based on online reading, where man doesn't shine.
... and the L<...>link format has it's ambiguities AFAIR.
Your turn to elaborate: What message are you trying to send? perlpodspec has a lot to say on the topic About L<...> Codes. I stick to the current spec, which includes a recommendation for heuristics how to deal with old, ambiguous links. perl-doc doesn't catch all links, but it works often enough to be above the threshold of goodenoughness.
I'd say HTML is the way to go if you supported more advanced features...
Indeed. POD enhancements which have already been discussed on P5P (no RFC/PPC yet) are tables and images. Both are supported by HTML and by the libraries used by perl-doc.

All that said: Emacs 29 comes with tree-sitter libraries, and I hope that the mainstream distributions will include these in their builds. The real competition for all HTML/man/info intermediates will then be native POD support in Emacs, based on tree-sitter-pod.

  • Comment on Re^4: Reading Perl documentation in Emacs