Source Locations

org.eclipse.pde.core.source

2.0

This extension point allows PDE to find source archives for libraries in Eclipse plug-ins found in an Eclipse-based product. It is used to contribute locations that contain source archives. These locations are expected to contain the same layout as the 'plugins' directory.

For each plug-in or fragment, a directory in the form {id}_{version} should exist. The content of the directory corresponds to the plug-in/fragment location. It should contain source code zip file in the form {library name}src.zip where library name is the name of the Java library that matches the source code. For JAR'd plug-ins and libraries named '.', the source zip file must be named simply src.zip.

In addition, it should contain any file or directory specified in the build.properties using src.includes variable.

<!ELEMENT extension (location+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT location EMPTY>

<!ATTLIST location

path CDATA #REQUIRED>


The following is an example of the source extension:
 

<extension point =

"org.eclipse.pde.core.source"

>

<location path=

"src"

/>

</extension>

In the example above, the source location src in the contributing plug-in has been registered.

No Java code is requied for this extension point.

Eclipse SDK comes with source plug-ins that contain source information for all the plug-ins and fragments in Eclipse SDK.