Skip to content

Commit

Permalink
document depreciation steps done/to do and other things
Browse files Browse the repository at this point in the history
  • Loading branch information
rcaputo committed Apr 30, 2001
1 parent a4c9dd9 commit 670b8c4
Showing 1 changed file with 26 additions and 21 deletions.
47 changes: 26 additions & 21 deletions Changes
Expand Up @@ -23,15 +23,27 @@ Version numbers have four fields: X.YYZZAA
| cvs tag -Rc v0_1009 .
`------------------------------------------------------------------------------

Future ????.??.?? (!!!)
-----------------------
Depreciation Schedule and Status (!!!)
--------------------------------------

POE is due for a round of breakage to make things more consistent.

1. In the wheels, rename /.*State/ to /.*Event/. Wheels don't
define states, they emit events. Calling Wheels' parameters
/.*State/ is inconsistent and confusing.

TODO: Verify that the new code passes existing tests.
TODO: Port existing tests and samples to /.*Event/.

TODO: Have the support and documentation changes on the CPAN for
28 days.

TODO: Add depreciation warnings for /.*State/ uses.

TODO: Have the depreciation warnings on the CPAN for 28 days.

TODO: Remove /.*State/ warnings and support.

2. ARG0..ARG9 in built-in events are silly. The whole point of
using array slices and constant offsets is to avoid positional
dependencies. Using ARG0..ARG9 defeats most of this technique's
Expand Down Expand Up @@ -67,32 +79,25 @@ POE is due for a round of breakage to make things more consistent.
in one big lump. Has anyone been holding off on requests because
they'd break stuff? Now's the time to speak up.

I've come up with this tentative depreciation schedule in the hopes
it'll minimize people's grief.

1. Release POE as/is with this depreciation schedule. This is the
RFC phase, and interested people should comment on it. This
may be version 0.13.
0.15 2001.??.??
---------------

2. Release POE with new the new parameters/behaviors/etc. and the
depreciated ones side-by-side. The documentation will be altered
to cover new things and briefly tell about the depreciated
things. This may be version 0.14.
Fix t/06_tk.t to skip if Tk is outdated, rather than fail.

3. Add warnings for depreciated things. Try not to make them too
obnoxious. This may be version 0.15.
Fix lib/deptest.perl to recognize Exporter on Solaris.

4. Remove the depreciated things altogether. This may be version
0.16.
Increase dependency checking information on Solaris in case attempts
to fix the Exporter bug aren't successful.

My plan is to wait at least a month between each CPAN release.
Bleeding edge interim releases will start off as maintenance on the
previous version and then become release candidates for the next one.
If it all goes as planned, this will give people at least 1/4 year to
update their programs.
Add /.*Event/ support to wheels. Code to support /.*Event/ and
/.*State/ is marked with the comment C<# STATE-EVENT>. Hooks for
depreciation warnings are also commented. Changed the documentation
to say /.*Event/ instead of /.*State/, so new users will not learn the
depreciated ways.


0.14 2001.04.21
0.14 2001.04.23
---------------

Fix POE::Kernel::Tk.pm so that it doesn't kill CPAN.pm's "r" command.
Expand Down

0 comments on commit 670b8c4

Please sign in to comment.