https://bz.apache.org/bugzilla/show_bug.cgi?id=59804
Bug ID: 59804
Summary: Add annotation for indicating when deprecated features
may be removed
Product: POI
Version: 3.15-dev
Hardware: PC
OS: All
Status: NEW
Severity: enhancement
Priority: P2
Component: POI Overall
Assignee: [email protected]
Reporter: [email protected]
As part of managing binary and source backwards compatibility, we have
@Internal, @Deprecated (and @deprecated javadoc), annotations.
We usually keep deprecated features around for at least 2 final releases before
removing, but sometimes never get around to removing the deprecated features.
This bug will try to better track the revisit of deprecated elements.
>From David North on the dev mailing list [1]:
> * Use the @Deprecated annotation in addition to the JavaDoc tag (which
> is useful for some IDEs anyway)
> * Invent our own @Removal annotation to contain the date/POI version of
> expected removal
>
> Then it would be easy to write a functional test which used reflection
> to check all @Deprecated annotated elements had an @Removal too, and to
> tell us when things come up as due to be removed.
Related: [2] finding the version when a feature was deprecated
[1]
http://apache-poi.1045710.n5.nabble.com/deprecated-handling-reloaded-tp5721071p5721078.html
[2]
http://apache-poi.1045710.n5.nabble.com/Finding-deprecated-methods-td5723416.html
--
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
