[doc] Issues in perlrepository.1perl

[hmartink]

Dear Perl maintainer, the manpage-l10n project[1] maintains a large number of translations of man pages both from a large variety of sources (including Perl) as well for a large variety of target languages.

During their work translators notice different possible issues in the original (english) man pages. Sometimes this is a straightforward typo, sometimes a hard to read sentence, sometimes this is a convention not held up and sometimes we simply do not understand the original.

We use several distributions as sources and update regularly (at least every 2 month). This means we are fairly recent (some distributions like archlinux also update frequently) but might miss your latest upstream version once in a while, so the error might be already fixed. We apologize and ask you to close the issue immediately if this should be the case, but given the huge volume of projects and the very limited number of volunteers we are not able to double check each and every issue.

Secondly we translators see the manpages in the neutral po format, i.e. converted and harmonized, but not the original source (be it man, groff, xml or other). So we cannot provide a true patch (where possible), but only an approximation which you need to convert into your source format.

Finally the issues I'm reporting have accumulated over time and are not always discovered by me, so sometimes my description of the problem my be a bit limited - do not hesitate to ask so we can clarify them.

I'm now reporting the issues for your project. If future reports should use another channel, please let me know.

[1] https://manpages-l10n-team.pages.debian.net/manpages-l10n/

Btw. I noticed that you said that missing perl-internal links are a limitation of your toolchain, because in HTML it does not look right. Is this still the case? Then I will not report this in the future, but I think in HTML it is quite sensible, as this can then be turned into proper hyperlinks within the Perl documentation, giving a nice reading experience.

PS. I left of the triple backticks as requested, hopefully this remains readible.

Man page: perlrepository.1perl Issue: perlhack → B(1)

"See perlhack for an explanation of Perl development, including the Super " "Quick Patch Guide for making and submitting a small patch."

Man page: perlrepository.1perl Issue: perlgit → B(1)

"See perlgit for detailed information about Perl\*(Aqs Git repository."

Man page: perlrepository.1perl Issue: perlrepository. → B.

"(The above documents supersede the information that was formerly here in " "perlrepository.)"