[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [platform-dev] Comments on API to remove
|
Hi Jens,
I think that is a good comment. Thanks!
Best regards, Lars
On Sat, May 23, 2020 at 5:33 PM Jens Lideström <jens@xxxxxxxxxxxx> wrote:
>
> I'm in the process of marking some old databinding API for removal. I'm
> not really sure how to write the Javadoc comment on the removed API.
>
> Is the following a good comment?
>
> /**
> * XXX
> * @deprecated This class will be removed in a future release. See
> * https://bugs.eclipse.org/bugs/show_bug.cgi?id=546820 for more
> * information. Use XXX instead.
> */
>
> The wiki [1] says the following on this subject:
>
> """
> 5. Annotate all APIs that are to be removed with @noreference, @noextend
> and @noimplement where applicable, update deprecation comment and add an
> entry in the porting guide. Do the same for API that depends on it. The
> deprecation comment and porting guide entry must explain how to adapt the
> client code and also include a link to the bug report to allow feedback
> from API adopters.
> """
>
> If my example above is a suitable comment I will update the wiki to
> include it.
>
> [1]: https://wiki.eclipse.org/Eclipse/API_Central/API_Removal_Process
>
> /Jens
>
>
> _______________________________________________
> platform-dev mailing list
> platform-dev@xxxxxxxxxxx
> To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/platform-dev
--
Eclipse Platform project co-lead
CEO vogella GmbH
Haindaalwisch 17a, 22395 Hamburg
Amtsgericht Hamburg: HRB 127058
Geschäftsführer: Lars Vogel, Jennifer Nerlich de Vogel
USt-IdNr.: DE284122352
Fax (040) 5247 6322, Email: lars.vogel@xxxxxxxxxxx, Web: http://www.vogella.com