Gilles Sadowski wrote: >>> Modified: >>> commons/proper/math/trunk/src/main/java/org/apache/commons/math/ConvergingAlgorithm.java >>> URL: >>> http://svn.apache.org/viewvc/commons/proper/math/trunk/src/main/java/org/apache/commons/math/ConvergingAlgorithm.java?rev=990792&r1=990791&r2=990792&view=diff >>> ============================================================================== >>> --- >>> commons/proper/math/trunk/src/main/java/org/apache/commons/math/ConvergingAlgorithm.java >>> (original) >>> +++ >>> commons/proper/math/trunk/src/main/java/org/apache/commons/math/ConvergingAlgorithm.java >>> Mon Aug 30 13:06:22 2010 >>> @@ -26,6 +26,8 @@ package org.apache.commons.math; >>> * @see ConvergenceException >>> * @version $Revision$ $Date$ >>> * @since 2.0 >>> + * @deprecated in 2.2 (to be removed in 3.0). Please use >>> + * {...@link IterativeAlgorithm} instead. >>> */ >>> public interface ConvergingAlgorithm { >>> >> These deprecations should go in the 2.x branch. Version 2.2 will be >> cut from the 2.x branch, so in order for users to see the >> deprecation annotation, it needs to be there. > > I hesitated to leave the deprecation indication, the more so that the > mentioned "IterativeAlgorithm" does not exist yet! > The issue is far from clear; see > https://issues.apache.org/jira/browse/MATH-413 > > This interface should probably disappear (or go into some other package) but > some classes still depend on it (in package "analysis.solvers"). >
That's fine. We don't have to decide this yet. The point that I was making is that what we should be doing to show intent to remove things in 3.0 is to add the deprecation annotations to the 2.x branch. That way, users will see the deprecation in the 2.2 release. Phil > > Gilles > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
