in reply to Changing API's of CPAN modules

Depends on how popular your module is :)

Instead of changing the API, I think it's much better/easier to rename your API and start fresh, so you don't have to worry about deprecation warnings or early adopters whining about the changes.

All you do is release a final version (unless you want to maintain both APIs) of the old API with a note in the documentation saying something like You should use API2 as API is no longer being maintained (if you wish to take over maintenance ...)

MJD says "you can't just make shit up and expect the computer to know what you mean, retardo!"
I run a Win32 PPM repository for perl 5.6.x and 5.8.x -- I take requests (README).
** The third rule of perl club is a statement of fact: pod is sexy.