[Po4a-Devel] Re: Example of dumper (along with references) using Pod::Simple?

Hello, I'm one of the authors of the https://po4a.org/ tool, which eases the translation of documentation in various formats. The idea is to parse the documentations, keep the structure and replace the content in english with the translated content. See https://po4a.org/man/man1/po4a.1.php for more information. (beware, the mailing lists of both projects are CCed) po4a is written in Perl, and uses Pod::Parser so far, but I'm considering switching to Pod::Simple instead, thus this email. I seem to understand that Pod::Parser is kinda deprecated and Pod::Simple superior (I guess you agree?). In addition, my biggest concern with Pod::Parser is that the reported line numbers are wrong. The library reports fancyful locations for the blocks it reports. For example, the following page reports that the presented page is in file po4a, line 2 (there is a link to the bottom right). https://hosted.weblate.org/translate/po4a/po4a-doc/en/?checksum=439ba747a... But when you click on that link, you see that it's not the right location at all. That's line 2 of the POD chunks, not of the whole file. I had a look at Pod::Simple to see how to convert po4a to the modernity, but I would appreciate to have some guidance, please. For reference, our code is here: https://github.com/mquinson/po4a/blob/master/lib/Locale/Po4a/Pod.pm

For now, we override initialize(), command(), verbatim() and textblock() and then call parse_from_file() on the provided file. First question: which of the many Pod::Simple examples should I look at to adapt this code? Sorry for this silly question, but you really have many examples... Second question: How do you retrieve the line number in the original text in your parsers? Will I have the same issue with the reported line numbers ignoring the cut parts of the file? Third question: Is it possible to get some information from the external blocks? (the parts that are not POD in the file) I would like to "see" the comments added to these parts, searching for specific comments that are intended for the translators. This is to implement something similar to --add-command of xgettext. Summarizing the first questions, I'm looking for a Pod::Simple example that would dump the content to stdout along with the line numbers at which the blocks are found. And if you feel that I'm off tracks and that my questions are not relevant, I really need your guidance... Thanks in advance, Mt.