On Wednesday, August 20, 2003, at 07:26 AM, Eric Pugh wrote:
I just realized something.. If we are going to start using the fulcrum
versions of services like Mimetype, pool, etc, don't we need to mark them as
deprecate ASAP? As in before 2.3 goes out the door? Otherwise we will have
to maintain them till 2.5 is released? If we mark them deprecated in 2.3,
then in 2.4 we can start using them. And in 2.5 actually remove the code...
Is that correct? Am I understanding the rules for deprecation?
Yes, that's how I understand the deprecation rules as well. I think this page is still the definitive deprecation rules: http://jakarta.apache.org/turbine/common/deprecation.html
"2. The amount of time between deprecation and removal must be at least one release of Turbine. It could be more than one version release before the deprecated item is removed, but it cannot be less than one version release. In other words, we can deprecate something in 2.1 and remove it in the release of 2.1.1. The amount of time between 2.1 and 2.1.1 could be measured in days, not months. Discussion will occur on the mailing list pertaining to the real number of versions between deprecation and removal. You will have a chance to express your concerns and we will take them into consideration. Most likely a major feature change will not be removed between a 2.1 and 2.1.1 release. Instead, we would wait until 2.2 to remove the deprecated items in that case.
The reason why we do not feel that time is of importance is because 6 months may not be a long enough time for a project to keep up and 2 weeks might be fine for another project. By focusing on deprecation through releases, people can choose to code against a specific version of Turbine and feel comfortable that their code will compile for at least one released version. This also gives people the chance to compile against various previous releases to do incremental upgrades and find out what will break in the next release."
Take care. -Eric
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
