Bug#471923: Some (all?) links in policy diagnostics have extra text

Matt Kraai kraai at ftbfs.org
Fri Mar 21 05:51:43 UTC 2008


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





More information about the pkg-perl-maintainers mailing list