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
Download (untitled) / with headers
text/plain 1.1k
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.


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

Please report any issues with rt.cpan.org to rt-cpan-admin@bestpractical.com.