Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 356360 - Broken Javadoc link: org.eclipse.platform.doc.isv/reference/api/org/eclipse/core/databinding/UpdateStrategy.DefaultConverter.html
Summary: Broken Javadoc link: org.eclipse.platform.doc.isv/reference/api/org/eclipse/c...
Status: VERIFIED FIXED
Alias: None
Product: Platform
Classification: Eclipse Project
Component: UI (show other bugs)
Version: 3.7.1   Edit
Hardware: All All
: P3 normal (vote)
Target Milestone: 4.4.1   Edit
Assignee: Markus Keller CLA
QA Contact:
URL:
Whiteboard:
Keywords:
: 388070 414234 (view as bug list)
Depends on:
Blocks:
 
Reported: 2011-08-31 11:39 EDT by Kit Lo CLA
Modified: 2014-08-03 07:19 EDT (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.