Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Eclipse Platform » Eclipse APIs & API Graduation
Eclipse APIs & API Graduation [message #642898] Fri, 03 December 2010 04:41 Go to next message
Businge Missing name is currently offline Businge Missing name
Messages: 8
Registered: April 2010
Junior Member
Hello,

Am doing a study on Eclipse APIs and non-APIs. Currently, I am trying to understand the Different terms used in the document http://wiki.eclipse.org/Provisional_API_Guidelines_Update_Pr oposal

What I have understood from reading this document and taking a look at the Eclipse source code is that Eclipse APIs are stored in packages that do not contain the segment "internal" and non-APIs are kept in packages having the segment internal. Please correct me if am wrong.

What has confused me again is a post on https://bugs.eclipse.org/bugs/show_bug.cgi?id=309247

where Scott writes that "The org.eclipse.equinox.concurrent.future API is currently marked as 'internal' because since it's original contribution has been considered in the 'provisional' state. I would like to request the graduation of this API."

When I checked in Eclipse 3.6 source code, I didn't find this package marked with the segment "internal".

Could someone please explain for me this.

Again on http://wiki.eclipse.org/Provisional_API_Guidelines_Update_Pr oposal

document I don't seem to understand exactly what what x-internal:=true/false means. Where can I find this statement in the sources of Eclipse.

Thank in advance

Kind regards,

John
Re: Eclipse APIs & API Graduation [message #645084 is a reply to message #642898] Wed, 15 December 2010 09:44 Go to previous message
Tomasz Zarna is currently offline Tomasz Zarna
Messages: 164
Registered: July 2009
Senior Member
The x-internal directive can be used in an Export-Package header in MANIFEST.MF to specify whether the package is an internal package. I guess "x-internal=true" was used here to mark the org.eclipse.equinox.concurrent.future package as hidden from all bundles (internal).

Cheers,
Tomek
Previous Topic:SaveAllAction NonPartSourcs
Next Topic:Mutliple Tabs not showing for Tabbed Properties view
Goto Forum:
  


Current Time: Tue Jul 22 21:46:06 EDT 2014

Powered by FUDForum. Page generated in 0.06487 seconds