Bug#696912: libperl-critic-perl: Documentation::RequirePodLinksIncludeText is obsolete

[Russ Allbery]

Salvatore Bonaccorso  writes:
> On Fri, Dec 28, 2012 at 11:43:14PM -0800, Russ Allbery wrote:

>> (I know this should to go RT, but I'm out of brain for the day.  I'll
>> forward it to RT probably tomorrow if someone doesn't beat me to it.)

> Forwarded to the RT: http://rt.cpan.org/Public/Bug/Display.html?id=82321

Thank you!

-- 
Russ Allbery (r...@debian.org)   


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Bug#696912: libperl-critic-perl: Documentation::RequirePodLinksIncludeText is obsolete

[Salvatore Bonaccorso]

Hi Russ

On Fri, Dec 28, 2012 at 11:43:14PM -0800, Russ Allbery wrote:
> (I know this should to go RT, but I'm out of brain for the day.  I'll
> forward it to RT probably tomorrow if someone doesn't beat me to it.)

Forwarded to the RT: http://rt.cpan.org/Public/Bug/Display.html?id=82321

Regards,
Salvatore


signature.asc
Description: Digital signature

Bug#696912: libperl-critic-perl: Documentation::RequirePodLinksIncludeText is obsolete

[Russ Allbery]

Package: libperl-critic-perl
Version: 1.117-2
Severity: wishlist

(I know this should to go RT, but I'm out of brain for the day.  I'll
forward it to RT probably tomorrow if someone doesn't beat me to it.)

Perl::Critic::Policy::Documentation::RequirePodLinksIncludeText says:

This Policy requires your POD links to contain text to override your POD
translator's default link text, where this is possible. Failure to
provide your own text leaves you at the mercy of the POD translator,
which may display something like "L" as "the Foo manpage".

That display of L as "the Foo manpage" was something that was only
done in Pod::Man and Pod::Text (and their predecessors).  I fixed that
bug in November of 2001.

It's possible that some other formatters picked up that bad habit from
pod2man and pod2text, but I'm not aware of any, and this was discussed
quite a bit on pod-peo...@perl.org.  Plus, perlpodspec specifically says:

  *   In case of L<...> codes with no "text|" part in them, older
  formatters have exhibited great variation in actually displaying
  the link or cross reference.  For example, L would
  render as "the crontab(5) manpage", or "in the crontab(5) manpage"
  or just "crontab(5)".

  Pod processors must now treat "text|"-less links as follows:

L =>  L
L =>  L<"section"|/section>
L =>  L<"section" in name|name/section>

and has since the beginning of that document years ago, so at this point
any formatter that does something else is just buggy and should be fixed.

It's time to kill this policy and let everyone who has been tediously
writing L for the past 11 years unnecessarily
just write L and be happy.

-- System Information:
Debian Release: wheezy/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)

Kernel: Linux 3.2.0-3-686-pae (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages libperl-critic-perl depends on:
ii  libb-keywords-perl   1.12-1
ii  libconfig-tiny-perl  2.14-1
ii  libemail-address-perl1.895-1
ii  libexception-class-perl  1.32-1
ii  libfile-homedir-perl 0.99-1
pn  libfile-spec-perl
ii  libfile-which-perl   1.09-1
ii  libio-string-perl1.08-2
ii  liblist-moreutils-perl   0.33-1+b1
ii  libpod-spell-perl1.01-2
ii  libppi-perl  1.215-1
ii  libppix-regexp-perl  0.028-1
ii  libppix-utilities-perl   1.001000-1
ii  libreadonly-perl 1.03-4
ii  libreadonly-xs-perl  1.04-2+b3
ii  libstring-format-perl1.16-1
ii  libtask-weaken-perl  1.03-1
ii  perl 5.14.2-16
ii  perl-modules [libmodule-pluggable-perl]  5.14.2-16
ii  perltidy 20101217-1

libperl-critic-perl recommends no packages.

libperl-critic-perl suggests no packages.

-- no debconf information


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org