Generally when I use @Deprecate alone it means there is no replacement. But I marked this change with that sentiment.
Right now I consider Maven to be and end user tool. The jumble of components we have let leak to confuse most integrators I would not consider much of an API or SPI. With 4.0.0 I'm pretty much going to shut most things down and be very careful about what gets opened up again. I imagine 4.0.0 will be stable from a functionality perspective but take a while to reach a final 4.0.0. I plan to do the work in the 3.x line where I carefully collect everything that's deprecated and document what's going to be removed. The new APIs will collect in the 3.x line and I will use a tool to remove all the deprecated code to see the affect. Effectively branching by abstraction which is a technique I prefer. I can also see what APIs every plugin in Maven Central uses so that will give me some idea about what to instruct plugin developers to do in order to update. On Jul 5, 2014, at 8:44 AM, William Ferguson <william.fergu...@xandar.com.au> wrote: > The original Java deprecation guidelines were to > 1) Include a "since" statement indicating at point the API was deprecated > 2) include a statement pointing to the replacement API (or non-replacement > and reason for same). > > > On Sat, Jul 5, 2014 at 10:34 PM, Robert Scholte <rfscho...@apache.org> > wrote: > >> +1, I often hit deprecated code without knowing what to use instead. A >> hint would certainly help. >> >> Robert >> >> Op Sat, 05 Jul 2014 14:32:14 +0200 schreef Hervé BOUTEMY < >> herve.bout...@free.fr>: >> >> >> when we deprecate somthing like this, we should add a hint on what to do >>> instead: we have a bunch of deprecated things without any idea on what to >>> do >>> I don't know how we can fix the existing deprecations, but at least I'd >>> like to >>> avoid adding more such "dead-end" deprecations >>> >>> Regards, >>> >>> Hervé >>> >>> Le samedi 5 juillet 2014 12:19:01 jvan...@apache.org a écrit : >>> >>>> Repository: maven >>>> Updated Branches: >>>> refs/heads/master 963373726 -> 9cc2caeb9 >>>> >>>> >>>> Deprecate unused version of the project dependencies resovler in the core >>>> >>>> >>>> Project: http://git-wip-us.apache.org/repos/asf/maven/repo >>>> Commit: http://git-wip-us.apache.org/repos/asf/maven/commit/9cc2caeb >>>> Tree: http://git-wip-us.apache.org/repos/asf/maven/tree/9cc2caeb >>>> Diff: http://git-wip-us.apache.org/repos/asf/maven/diff/9cc2caeb >>>> >>>> Branch: refs/heads/master >>>> Commit: 9cc2caeb9f54e44587e7642bb43592de7e177f4f >>>> Parents: 9633737 >>>> Author: Jason van Zyl <ja...@tesla.io> >>>> Authored: Sat Jul 5 08:18:38 2014 -0400 >>>> Committer: Jason van Zyl <ja...@tesla.io> >>>> Committed: Sat Jul 5 08:18:38 2014 -0400 >>>> >>>> ---------------------------------------------------------------------- >>>> .../java/org/apache/maven/DefaultProjectDependenciesResolver.java | >>>> 1 + >>>> .../src/main/java/org/apache/maven/ProjectDependenciesResolver.java | >>>> 1 + >>>> 2 files changed, 2 insertions(+) >>>> ---------------------------------------------------------------------- >>>> >>>> >>>> http://git-wip-us.apache.org/repos/asf/maven/blob/9cc2caeb/ >>>> maven-core/src/ma >>>> in/java/org/apache/maven/DefaultProjectDependenciesResolver.java >>>> ---------------------------------------------------------------------- >>>> diff >>>> --git >>>> a/maven-core/src/main/java/org/apache/maven/ >>>> DefaultProjectDependenciesResol >>>> ver.java >>>> b/maven-core/src/main/java/org/apache/maven/ >>>> DefaultProjectDependenciesResol >>>> ver.java index d511d1d..3511d90 100644 >>>> --- >>>> a/maven-core/src/main/java/org/apache/maven/ >>>> DefaultProjectDependenciesResol >>>> ver.java +++ >>>> b/maven-core/src/main/java/org/apache/maven/ >>>> DefaultProjectDependenciesResol >>>> ver.java @@ -42,6 +42,7 @@ import >>>> org.apache.maven.repository.RepositorySystem; import >>>> org.codehaus.plexus.component.annotations.Component; >>>> import org.codehaus.plexus.component.annotations.Requirement; >>>> >>>> +@Deprecated >>>> @Component( role = ProjectDependenciesResolver.class ) >>>> public class DefaultProjectDependenciesResolver >>>> implements ProjectDependenciesResolver >>>> >>>> http://git-wip-us.apache.org/repos/asf/maven/blob/9cc2caeb/ >>>> maven-core/src/ma >>>> in/java/org/apache/maven/ProjectDependenciesResolver.java >>>> ---------------------------------------------------------------------- >>>> diff >>>> --git >>>> a/maven-core/src/main/java/org/apache/maven/ProjectDependenciesResolver. >>>> jav >>>> a >>>> b/maven-core/src/main/java/org/apache/maven/ProjectDependenciesResolver. >>>> jav >>>> a index 7ae86fd..5a14b6f 100644 >>>> --- >>>> a/maven-core/src/main/java/org/apache/maven/ProjectDependenciesResolver. >>>> jav >>>> a +++ >>>> b/maven-core/src/main/java/org/apache/maven/ProjectDependenciesResolver. >>>> jav >>>> a @@ -28,6 +28,7 @@ import >>>> org.apache.maven.artifact.resolver.ArtifactResolutionException; import >>>> org.apache.maven.execution.MavenSession; >>>> import org.apache.maven.project.MavenProject; >>>> >>>> +@Deprecated >>>> public interface ProjectDependenciesResolver >>>> { >>>> >>> >>> >>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org >>> For additional commands, e-mail: dev-h...@maven.apache.org >>> >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org >> For additional commands, e-mail: dev-h...@maven.apache.org >> >> Thanks, Jason ---------------------------------------------------------- Jason van Zyl Founder, Apache Maven http://twitter.com/jvanzyl http://twitter.com/takari_io --------------------------------------------------------- A man enjoys his work when he understands the whole and when he is responsible for the quality of the whole -- Christopher Alexander, A Pattern Language
