Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [platform-ui-dev] requestion plugin cleanup

On Thursday February 23 2006 01:30 pm, Randy Hudson wrote:
> If use is discouraged, how was it ever provisional? I plan on providing
> provisional API that is not used internally by my component. It exists
> solely for clients.  IMO, this is the classic "provisional" (vs. stuff
> that is used internally, and a few clients have asked to promote to API).
> So, if I have code that is not even used internally, why would I mark it
> "internal"?

Say I'm a developer who sees some wonderful snippet of code on the web.  It 
indicates I should use some class.  If I like using Ctrl+Space and 
Ctrl+Shift+O, I may never know that it came from a package called "internal".  
If it is marked "x-internal", then it will appear as a warning.  A curious 
developer can then look at the javadoc, and see that it is described as 
provisional and make a decision based on that.

I guess I just feel that without the "x-internal", it is too easy in Eclipse 
to use provisional APIs without realizing.


Back to the top