It might be nice to add a mention of the feature intended to replace it. Even a quick mention such as "See L<perlfoo/given> for the preferred method of accomplishing this." would be a help. (Sorry no patch; another reason mobiles are painful.) Regards, Charles Bailey On 4/15/09, Dave Mitchell <davem@iabyn.com> wrote: > On Mon, Feb 23, 2009 at 10:46:29AM +0000, Nicholas Clark wrote: >> I did this: >> >> commit e76b2c0c0a5a6bcf7f940f55f050b6f3cecac437 >> Author: Nicholas Clark <nick@ccl4.org> >> Date: Mon Feb 23 11:27:08 2009 +0100 >> >> Add deprecate.pm. Deprecate shipping Switch.pm in the core >> distribution. > > How about I add the following entry to the 5.10.1 delta?: > > =head1 Deprecations > > The following items are now deprecated. > > =over > > =item * > > C<Switch> is buggy and should be avoided where possible. From perl > 5.11.0 > onwards it is intended that any use of the core version of this module > will emit a warning, and that the module will eventually be removed from > the core (probably in perl 5.14.0). > > By putting it in perl5101delta.pod, it gives more advanced notice > (assuming 5.10.1 is released before 5.12.0 ;-) > > -- > Technology is dominated by two types of people: those who understand what > they do not manage, and those who manage what they do not understand. > -- Regards, Charles Bailey Lists: bailey _dot_ charles _at_ gmail _dot_ com Other: bailey _at_ newman _dot_ upenn _dot_ eduThread Previous | Thread Next