On Sat, Oct 25, 2025 at 02:25:48PM -0600, Karl Berry wrote: > gnustandards just pulls in the canonical one in texinfo. > > In addition to what Paul said, I can report that I originally wrote the > contrib/perldoc-all stuff (many years ago) as an exercise of pod2texi, > and to have the perl documentation in texinfo. It was not canonical in > any way. > > I also don't know if it still works. I see in perldoc-all/README that > "many internal links are missing" from the result.
It never really worked well, because of the issue I reported in the README, of missing links, that was there since the beginning. Because of that, I do not think that it can be that useful as a document. I test from time to time and as far as I can tell it still works as it did before. I do not think that we should fix the links, though, as the Perl documentation generation does not follow the Pod specification, while pod2texi does. It is not clear what should be done to follow the Perl documentation generation, it is not specified clearly anywhere, I have not checked especially but my recalling is one would have to look at the code of Pod::Simple::Role::XHTML::WithExtraTargets, and I do not think that this is important enough to add complexity to pod2texi. > As far as I'm concerned the whole contrib/perldoc-all directory could > (should?) be deleted. I doubt anyone is using it. -k Nobody use it, but I see no reason to remove it either. I test it sometime, although very irregularly. It still seems to me to be a good check for pod2texi. -- Pat
