Branch: refs/heads/blead
Home: https://github.com/Perl/perl5
Commit: 3c6cd8bb4c475d07e12769dacb3140aff967923e
https://github.com/Perl/perl5/commit/3c6cd8bb4c475d07e12769dacb3140aff967923e
Author: Lukas Mai <lukasmai....@gmail.com>
Date: 2025-03-19 (Wed, 19 Mar 2025)
Changed paths:
M t/porting/podcheck.t
Log Message:
-----------
t/porting/podcheck.t: allow ' in English words
podcheck.t uses a crude heuristic to identify links that use the wrong
POD syntax (e.g. C<Some::Module> instead of L<Some::Module>): It checks
whether the word before the C<...> markup was "see". This has the
potential for a lot of false positives, so it adds an additional check:
If the words before "see" include the word "you", we don't count it as a
link attempt. This is to rule out cases like "you may see C<mtfnpy> in
the output".
However, that heuristic failed on this example from perlport:
on Unix you'll see C<"a.">
This is because ' is not a word character, so the leading context was
just "ll", which doesn't contain "you":
not ok 241 - POD of pod/perlport.pod
# "? Should you be using L<...> instead of"
# C<"a."> near line 1104 of pod/perlport.pod
This patch teaches podcheck.t about common English short forms such as
"you'll", "you're", or "you'd".
To unsubscribe from these emails, change your notification settings at
https://github.com/Perl/perl5/settings/notifications
