Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Source Locations</title>
<style type="text/css">@import url("../../book.css");</style>
<style type="text/css">@import url("../../schema.css");</style>
<H1 style="text-align:center">Source Locations</H1>
<h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>org.eclipse.pde.core.source<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Since: </h6>2.0

<h6 class="CaptionFigColumn SchemaHeader">Description: </h6>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} 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 <code></code>.  
In addition, it should contain any file or directory specified in the using <code>src.includes</code> variable.<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6>
<p class="code SchemaDtd">&lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.location">location</a>+)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST extension</p>
<p class="code SchemaDtdAttlist">point&nbsp;CDATA #REQUIRED</p>
<p class="code SchemaDtdAttlist">id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p>
<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;CDATA #IMPLIED&gt;</p>
<ul class="ConfigMarkupAttlistDesc">
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.location">location</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST location</p>
<p class="code SchemaDtdAttlist">path&nbsp;CDATA #REQUIRED&gt;</p>
<ul class="ConfigMarkupAttlistDesc">
<li><b>path</b> - the relative path of the directory in the contributing plug-in where source content is stored. The folder must contain one or more directories in the form {id}_{version} where <code>id</code> is a matching plug-in or fragment identifier and <code>version</code> is the matching plugin/fragment version. These directories in turn should contain source archives and any other file or folder specified using <code>src.includes</code> variable in file of the corresponding plug-in/fragment.</li>
<br><h6 class="CaptionFigColumn SchemaHeader">Examples: </h6>The following is an example of the <code>source</code> extension:
<pre class="Example"><span class="code SchemaTag">
 &lt;extension point = </span><span class="code SchemaCstring">&quot;org.eclipse.pde.core.source&quot;</span><span class="code SchemaTag">&gt;
     &lt;location path=</span><span class="code SchemaCstring">&quot;src&quot;</span><span class="code SchemaTag">/&gt;

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

<h6 class="CaptionFigColumn SchemaHeader">API Information: </h6>No Java code is required for this extension point.

<h6 class="CaptionFigColumn SchemaHeader">Supplied Implementation: </h6>Eclipse SDK comes with source plug-ins that contain source information for all the plug-ins and fragments in Eclipse SDK.

<p class="note SchemaCopyright">
Copyright (c) 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made 
available under the terms of the Eclipse Public License v1.0 which 
accompanies this distribution, and is available at 
<a href=""></a>.

New to GrepCode? Check out our FAQ X