Provide user documentation with the summary of changes in "deprecation" area

[Phillipus]

In Eclipse 4.34 I have a class that is deprecated and a static reference to one of its methods in another class:

package example;

@Deprecated
public class Foo {
    public static void someStaticMethod() {
    }
}

package example;

import static example.Foo.someStaticMethod;

public class Other {
    @SuppressWarnings("deprecation")
    Other() {
        someStaticMethod();
    }
}

The @SuppressWarnings("deprecation") works as expected in class Other and all is well.

However, in Eclipse 4.38 (Build id: I20251029-1800) things are different:

1. There is a "The enclosing type Foo is deprecated, perhaps this member should be marked as deprecated, too?" info message for class Foo
2. There is a "Unnecessary @SuppressWarnings("deprecation")" warning for class Other

That's OK I guess but I can't find a way to ignore these messages in the Errors/Warnings preferences of the workspace. As I'm switching between versions of Eclipse if I fix these warnings in one version I get the inverse warnings in the other version.

[iloveeclipse]

This is a bug fix, see #4553

@stephan-herrmann : coukd you provide N&N entry and once done, send mails to "usual" mailing lists (including cross-project)?

[Phillipus]

This is a bug fix, see #4553

Thanks, that's a deep rabbit hole. :-)

Is this the expected behaviour now? Will there be options added to fine tune these warnings?

[iloveeclipse]

Is this the expected behaviour now? Will there be options added to fine tune these warnings?

Yes, see #4568.
See also #4572 for all related changes.

I hope the yet to be written N&N will answer all your other future questions :-).

[stephan-herrmann]

@stephan-herrmann : coukd you provide N&N entry and once done, send mails to "usual" mailing lists (including cross-project)?

Yes, I'm planning to do so. I just wanted to complete the picture before announce incomplete stuff :)

I hope, in particular, that people will like what's coming via eclipse-jdt/eclipse.jdt.ui#2587 !

[Phillipus]

Thanks, everyone!

[stephan-herrmann]

Documentation is online at https://eclipse.dev/eclipse/markdown/?f=news/4.38/jdt.md#changes-concerning-deprecation-warnings