Thu Jul 11 15:03:36 2019 jidanni@jidanni.org - Correspondence added
The main problem is on man XML::LibXML we see it mentioning all the places one is supposed to look for everything, many many pages. But on man PDF::API2 there is not even a SEE ALSO section.
Thu Jul 11 15:03:45 2019 jidanni@jidanni.org - Correspondence added
OK but the main problem is on man XML::LibXML we see it mentioning all the places one is supposed to look for everything, many many pages. But on man PDF::API2 there is not even a SEE ALSO section. For us users we only follow what is mentioned and do not use e.g., dlocate -L libpdf-api2-perl to see where things might be hidden.
Fri Jul 12 10:00:58 2019 PMPERRY@cpan.org - Correspondence added
Understood and agreed that the documentation has accreted over the years in a haphazard manner. I can't do anything about PDF::API2, but I have been upgrading PDF::Builder's docs bit by bit, and will keep your points in mind.
What is really needed is a comprehensive, task-oriented overview, but unless someone shows that a book ($$) would be in sufficient demand to make it worthwhile writing one, I'm afraid that major doc revisions and improvements will come slowly.