Bug#471923: Some (all?) links in policy diagnostics have extra text
kraai at ftbfs.org
Fri Mar 21 05:51:43 UTC 2008
At least some of the links in the policy descriptions are rendered as
"the LINK manpage", which often looks odd:
$ cat >foo <<EOF
$ perlcritic --gentle foo
Code before strictures are enabled at line 1, near '1;'.
TestingAndDebugging::RequireUseStrict (Severity: 5)
Using strictures is probably the single most effective way to improve
the quality of your code. This policy requires that the `'use strict''
statement must come before any other statements except `package',
`require', and other `use' statements. Thus, all the code in the entire
package will be affected.
There is a special exemption for the Moose manpage because it enforces
strictness; i.e. `'use Moose'' is treated as equivalent to `'use
(See the first sentence of the second paragraph.) According to
perlpod, the link should be changed from "L<Moose>" to
"L<Moose|Moose>" to avoid this problem.
More information about the pkg-perl-maintainers