| CC: | Matt Kraai <kraai [...] ftbfs.org> |
| Subject: | From Debian: Some (all?) links in policy diagnostics have extra text |
| Date: | Mon, 07 Jul 2008 08:40:58 -0500 |
| To: | bug-Perl-Critic [...] rt.cpan.org |
| From: | Elliot Shank <perl [...] galumph.com> |
This is a copy of the Debian bug report at http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=471923.
Package: libperl-critic-perl
Version: 1.082-1
At least some of the links in the policy descriptions are rendered as
"the LINK manpage", which often looks odd:
$ cat >foo <<EOF
1;
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
strict''.
(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.
--
Matt