[doc] Issues in perl5224delta.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: perl5224delta.1perl Issue: perl5223delta → B(1perl)

"If you are upgrading from an earlier release such as 5.22.2, first read " "perl5223delta, which describes differences between 5.22.2 and 5.22.3."

Man page: perl5224delta.1perl Issue: Module::CoreList → BModule::CoreList(3)

"Module::CoreList has been upgraded from version 5.20170114_22 to " "5.20170715_22."

Man page: perl5224delta.1perl Issue: perlbug → B(1)

"If you believe you have an unreported bug, please run the perlbug program " "included with your release. Be sure to trim your bug down to a tiny but " "sufficient test case. Your bug report, along with the output of " "CW<\(C`perl -V\(C'>, will be sent off to [email protected] to be analysed " "by the Perl porting team."