Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 356360

Summary: Broken Javadoc link: org.eclipse.platform.doc.isv/reference/api/org/eclipse/core/databinding/UpdateStrategy.DefaultConverter.html
Product: [Eclipse Project] Platform Reporter: Kit Lo <kitlo>
Component: UIAssignee: Markus Keller <markus.kell.r>
Status: VERIFIED FIXED QA Contact:
Severity: normal    
Priority: P3 CC: daniel_megert, markus.kell.r, matalbot, remy.suen, srlim
Version: 3.7.1   
Target Milestone: 4.4.1   
Hardware: All   
OS: All   
Whiteboard:

Comment 1 Dani Megert CLA 2011-09-01 03:51:00 EDT
Note sure whether this is in UI as it is core.databinding.

The problem is that some API classes extend a package visible class. This is doomed to fail - not just for generating Javadoc.
Comment 2 Dani Megert CLA 2011-09-01 03:51:24 EDT
> The problem is that some API classes extend a package visible class
==> org.eclipse.core.databinding.UpdateStrategy
Comment 3 Remy Suen CLA 2011-11-18 10:44:49 EST
(In reply to comment #1)
> Note sure whether this is in UI as it is core.databinding.

Yes, this is in UI.

> The problem is that some API classes extend a package visible class. This is
> doomed to fail - not just for generating Javadoc.

What do you suggest, Dani? Or is this something we'll just have to live with.
Comment 4 Dani Megert CLA 2011-11-21 03:38:53 EST
(In reply to comment #3)
> (In reply to comment #1)
> > Note sure whether this is in UI as it is core.databinding.
> 
> Yes, this is in UI.
> 
> > The problem is that some API classes extend a package visible class. This is
> > doomed to fail - not just for generating Javadoc.
> 
> What do you suggest, Dani? 

The simplest fix is to remove the 'protected' from 
org.eclipse.core.databinding.UpdateStrategy.DefaultConverter. This doesn't make sense anyway because the containing class is already restricted to the package. This will prevent this type's Javadoc from being generated.
Comment 5 Dani Megert CLA 2012-08-27 03:32:30 EDT
*** Bug 388070 has been marked as a duplicate of this bug. ***
Comment 6 Dani Megert CLA 2013-08-02 03:55:08 EDT
*** Bug 414234 has been marked as a duplicate of this bug. ***
Comment 8 Markus Keller CLA 2014-07-17 06:40:28 EDT
Verified in N20140716-2000.
Comment 9 Dani Megert CLA 2014-07-28 04:18:54 EDT
Was this fix really necessary given you already fixed it via bug 437834? In the end I'd prefer to revert the fix for bug 437834 and keep this one (also backport this one to 4.4.1).
Comment 10 Markus Keller CLA 2014-07-28 11:46:56 EDT
(In reply to Dani Megert from comment #9)
> Was this fix really necessary given you already fixed it via bug 437834?

The fix is necessary, since it's about a completely separate problem, see bug 437834 comment 1.

Bug 437834 was
- partly a dup of this bug (which is about UpdateStrategy.DefaultConverter)
- plus a completely separate problem (SWTEventListener)

The fix for bug 437834 only fixes the SWTEventListener problem, and it did that without any code change.

This fix is slightly more risky, since it actually reduces the visibility of a nested static class. Though the risk is negligible, since the outer class is package-visible, and therefore, the nested class could never be referenced by Java code.

Please reopen if you'd like this fix backported as well.
Comment 11 Dani Megert CLA 2014-07-29 06:45:06 EDT
(In reply to Markus Keller from comment #10)
> (In reply to Dani Megert from comment #9)
> > Was this fix really necessary given you already fixed it via bug 437834?
> 
> The fix is necessary, since it's about a completely separate problem, see
> bug 437834 comment 1.
> 
> Bug 437834 was
> - partly a dup of this bug (which is about UpdateStrategy.DefaultConverter)
> - plus a completely separate problem (SWTEventListener)
> 
> The fix for bug 437834 only fixes the SWTEventListener problem, and it did
> that without any code change.
> 
> This fix is slightly more risky, since it actually reduces the visibility of
> a nested static class. Though the risk is negligible, since the outer class
> is package-visible, and therefore, the nested class could never be
> referenced by Java code.
> 
> Please reopen if you'd like this fix backported as well.

Ah, right.

Backported to R4_4_maintenance with http://git.eclipse.org/c/platform/eclipse.platform.ui.git/commit/?id=94ab3e957940f966292cd38bf121015a523a0ae0
Comment 12 Dani Megert CLA 2014-08-03 07:19:12 EDT
Verified in M20140731-1200.