[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Hi,
I'd rather use these annotations as JavaDoc tags, for the following
reasons:
1) The @deprecated JavaDoc tag allows us to tell developers what they
are expected to do (like "use this and that other class / method)
2) If we later want to use the PDE API tooling or convince the PDE
team to enhance the PDE API tooling to support our annotations, we
should be compatible. As they are using JavaDoc tags, so should we.
3) If we introduce an annotation @org.eclipse.xtext.Stable, we have a
tie-in to Xtext. We might want to use the same mechanism in Xpand,
Xtend, etc. by using JavaDoc tags, we're more flexible.
Cheers,
Peter
On 05.03.2009, at 10:20, Sven Efftinge wrote:
Hi,
I've written something about our API policy:
http://wiki.eclipse.org/Xtext/Documentation/API
Please review.
Cheers,
Sven
_______________________________________________
xtext-dev mailing list
xtext-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/xtext-dev