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