Source Code Locations

In Eclipse, source code and extension point schemas are shipped in separate source plug-ins. A source plug-in is a plug-in containing one or more source code locations.

Declared Source Code Locations

A declared (pre-defined) source code location is an org.eclipse.pde.core.source extension.

Eclipse 3.3 comes with seven pre-defined source code locations. The extension point schemas and source archive(s) for a plug-in are located in a unique subdirectory under one of these source code locations.

Each subdirectory must have the {id}_{version} naming convention, where id is the plug-in ID and version is the plug-in version.

For instance, org.eclipse.pde.source is the plug-in containing the source code for all org.eclipse.pde.* plug-ins.

Therefore, the source code and extension point schemas for the org.eclipse.pde.core plug-in are located at {eclipse_installation}/plugins/org.eclipse.pde.source_3.3.0.{qualifier}/src/org.eclipse.pde.core_3.3.0.{qualifier}/

Additional Source Code Locations

Additional source code locations can be specified without the use of an org.eclipse.pde.core.source extension by simply pressing Add... to browse the file system.

The subdirectories of the additional source code locations must follow the same layout and naming conventions described above for the declared source code locations.

Source Archive Naming Convention

The ZIP archive containing the source code for a plug-in must follow the {library_name}src.zip naming convention.

For example, if a plug-in has the Bundle-ClassPath: xyz.jar MANIFEST.MF header, then the source code must be packaged in a ZIP archive named xyzsrc.zip.

If the plug-in has no Bundle-ClassPath MANIFEST.MF header or the header is of the form Bundle-ClassPath: . , then the source code must be packaged in a ZIP archive named src.zip.