Skip Menu |

Preferred bug tracker

Please visit the preferred bug tracker to report your issue.

This queue is for tickets about the Module-CoreList CPAN distribution.

Report information
The Basics
Id: 104270
Status: open
Priority: 0/
Queue: Module-CoreList

People
Owner: Nobody in particular
Requestors: dmacks [...] netspace.org
Cc:
AdminCc:

Bug Information
Severity: (no value)
Broken in: (no value)
Fixed in: (no value)



Subject: Confusing wording for deprecated modules in 'corelist' output
Date: Wed, 06 May 2015 14:22:21 -0400
To: bug-Module-CoreList [...] rt.cpan.org
From: "Daniel Macks" <dmacks [...] netspace.org>
$ corelist CGI               Data for 2015-04-20 CGI was first released with perl 5.004, deprecated (will be CPAN-only) in v5.19.7 and removed from v5.21.0 The phrase about deprecation is a confusing grammar, inconsistent with the other two. It sounds like it will become CPAN-only as of 5.19.7, and then beyond that, a separate statement about it being removed could mean that it wouldn't even be available from CPAN after 5.21.0. The deprecation comment is a forward-looking statement about some version beyond that. How about: CGI was first released with perl 5.004, deprecated in v5.19.7 and removed from v5.21.0 All self-consistent wording referring to what's in perl core. Or else: CGI was first released with perl 5.004, deprecated (will be removed in the future) in v5.19.7 and removed from v5.21.0 if you want to emphasize that it's not just a "don't recommend use" (but no problem if still using it for legacy code) situation but that "you will have to make alternative plans if you want to keep using it". dan -- Daniel Macks dmacks@netspace.org
On 2015-05-06 14:22:48, dmacks@netspace.org wrote: Show quoted text
> $ corelist CGI > Data for 2015-04-20 > CGI was first released with perl 5.004, deprecated (will be CPAN-only) > in v5.19.7 and removed from v5.21.0 > > The phrase about deprecation is a confusing grammar, inconsistent with > the other two. It sounds like it will become CPAN-only as of 5.19.7, > and then beyond that, a separate statement about it being removed > could mean that it wouldn't even be available from CPAN after 5.21.0. > The deprecation comment is a forward-looking statement about some > version beyond that. How about: > > CGI was first released with perl 5.004, deprecated in v5.19.7 and > removed from v5.21.0 > > All self-consistent wording referring to what's in perl core. Or else: > > CGI was first released with perl 5.004, deprecated (will be removed in > the future) in v5.19.7 and removed from v5.21.0 > > if you want to emphasize that it's not just a "don't recommend use" > (but no problem if still using it for legacy code) situation but that > "you will have to make alternative plans if you want to keep using > it". >
I think "deprecated" is the wrong term here. Better would be something like "announced for removal" or so.