Bug 546820 - [DataBinding] Mark deprecated observable factory classes for deletion
Summary: [DataBinding] Mark deprecated observable factory classes for deletion
Status: RESOLVED FIXED
Alias: None
Product: Platform
Classification: Eclipse Project
Component: UI (show other bugs)
Version: 4.11   Edit
Hardware: PC Linux
: P3 normal (vote)
Target Milestone: 4.17 M1   Edit
Assignee: Jens Lideström CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on: 540355 564010
Blocks:
  Show dependency tree
 
Reported: 2019-04-29 08:11 EDT by Lars Vogel CLA
Modified: 2020-06-22 06:03 EDT (History)
2 users (show)

See Also:
Lars.Vogel: pmc_approved+


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Lars Vogel CLA 2019-04-29 08:11:54 EDT
I suggest to mark the deprecated ViewersObservables methods for deletion.

Process: https://wiki.eclipse.org/Eclipse/API_Central/API_Removal_Process
Comment 1 Lars Vogel CLA 2019-04-29 08:13:51 EDT
Jens, something for you?
Comment 2 Jens Lideström CLA 2019-06-20 09:01:19 EDT
(In reply to Lars Vogel from comment #1)
> Jens, something for you?

Okay, I'll do this while I also do for the property factories (bug 546822).
Comment 3 Lars Vogel CLA 2020-05-18 07:48:02 EDT
Jens, can we start the deprecation? Will be two more years before we can delete them.
Comment 4 Jens Lideström CLA 2020-05-18 14:29:26 EDT
I (In reply to Lars Vogel from comment #3)
> Jens, can we start the deprecation? Will be two more years before we can
> delete them.

Oh, I missed this, I can fix it during the weekend.
Comment 5 Eclipse Genie CLA 2020-05-23 06:24:36 EDT
New Gerrit change created: https://git.eclipse.org/r/163460
Comment 6 Jens Lideström CLA 2020-05-23 07:14:40 EDT
There is a lot of other obsolete and deprecated observable factory classes, apart from ViewersObservables:

ViwersObservables
SWTObservables
BeansObservables
PojoObservables
WorkbenchObservables

These other classes were all deprecated in 2014, when the databinding framework was transitioned to work with property objects. The ViewersObservables and WorkbenchObservables classes were probably overlooked at that time, so they were not marked as deprecated.

Conclusion: When we mark ViewersObservables for deletion we should probably also mark the other observable factory classes for deletion.

I suggest that we change this ticket to include all the classes above. It will then include the following work:

* Deprecate WorkbenchObservables
* Adjust deprecation on ViwersObservables to apply to the whole class (by mistake I wanted to save one method previously)
* Mark all of the above classes for deletion

I can start working on this. (But it will probably take a while because I can't spend that much time on it.)
Comment 7 Lars Vogel CLA 2020-05-23 07:34:51 EDT
> I suggest that we change this ticket to include all the classes above. 

+1

> I can start working on this.

I think we should target 4.17, 4.16 is already in release freeze, so no pressure.
Comment 8 Eclipse Genie CLA 2020-05-23 12:18:57 EDT
New Gerrit change created: https://git.eclipse.org/r/163466
Comment 9 Eclipse Genie CLA 2020-05-23 12:30:10 EDT
New Gerrit change created: https://git.eclipse.org/r/163467
Comment 10 Jens Lideström CLA 2020-05-24 03:34:19 EDT
The following Gerrits contains the updates to the code and the update to removals.html:

https://git.eclipse.org/r/163466
https://git.eclipse.org/r/163467

This should be finished.
Comment 11 Jens Lideström CLA 2020-05-24 03:49:41 EDT
Arg, WorkbenchProperties doesn't contain all functionality that WorkbenchObservers contains. I have to think about how this should be handled.
Comment 12 Jens Lideström CLA 2020-06-06 06:40:53 EDT
 (In reply to Jens Lideström from comment #11)
> Arg, WorkbenchProperties doesn't contain all functionality that
> WorkbenchObservers contains.

I will add all functionality from WorkbenchObservables to WorkbenchProperties. After that we can deprecate WorkbenchObservables. See the new Bug 564010.

The implementation is finished, but the WorkbenchObservables doesn't have unit tests, so ideally I should create some to verify correctness since I'm moving things around...
Comment 13 Eclipse Genie CLA 2020-06-18 13:57:55 EDT
New Gerrit change created: https://git.eclipse.org/r/165176
Comment 17 Jens Lideström CLA 2020-06-22 04:23:48 EDT
All active steps of the removal procedure has been completed.

The following has been done:

* Added replacement methods to WorbenchProperties (see bug  564010).
* Got PMC approval.
* Added comments and annotations to the code.
* Added a removal note to the Porting Guide.
* Announced the removal on the cross-project-issues-dev mailing list.

Now only patience is needed.
Comment 18 Lars Vogel CLA 2020-06-22 04:28:18 EDT
Thanks Jens, we can mark this one as fixed and open a new bug in 2 years for the deletion.