Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<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>
</HEAD>
<BODY>
<H1 style="text-align:center">Source Locations</H1>
<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>org.eclipse.pde.core.source<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Since: </h6>2.0
<p></p>

<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. 
<p>
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 <code>src.zip</code>.  
<p>
In addition, it should contain any file or directory specified in the build.properties using <code>src.includes</code> variable.<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6>
<p></p>
<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>
<p></p>
<ul class="ConfigMarkupAttlistDesc">
</ul>
<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>
<p></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 build.properties file of the corresponding plug-in/fragment.</li>
</ul>
<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;
  &lt;/extension&gt;
</span></pre>

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

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

<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></p>

<br>
<p class="note SchemaCopyright">
Copyright (c) 2004 IBM Corporation and others.
<br>
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="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.

</p>
</BODY>
</HTML>
New to GrepCode? Check out our FAQ X