2013/9/27 Jean Forget <j2n-for...@orange.fr>: > I wanted to find if the website has any advices on programming > or on managing module releases. My present concern is > https://rt.cpan.org/Public/Bug/Display.html?id=77710 > replacing the API keyword "iteration" with "precise" > in DateTime::Event::Sunrise. And I have at least one other > keyword change (altitude -> height) > The various steps would be: > 1) silently accept both old and new keywords > 2) accept both keywords, but emit a warning if the old keyword is used > 3) accept only the new keyword.
Just mark the old keywords as deprecated in the documentation (or even remove them completely after a few releases and a warning in the Changes file). In the code, accept both the old and new keywords forever and don't try to apply technical measures to enforce that the new keywords are used: your API users (or the users of your users, or their users) don't deserve that pain. Olivier Mengué.
