Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDarin Wright2004-04-15 14:24:31 -0400
committerDarin Wright2004-04-15 14:24:31 -0400
commit48c92d5c42e6af5046b770531047aa8036995443 (patch)
treef69d9b205858d18fce6409d1eec37a0bad9acc70
parentb38f8e34f1839e7962394a4a855fb7b636d2da24 (diff)
downloadeclipse.platform.debug-48c92d5c42e6af5046b770531047aa8036995443.tar.gz
eclipse.platform.debug-48c92d5c42e6af5046b770531047aa8036995443.tar.xz
eclipse.platform.debug-48c92d5c42e6af5046b770531047aa8036995443.zip
API review
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java4
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java13
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java6
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java6
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java6
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java17
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java24
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainer.java2
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java2
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ArchiveSourceContainer.java5
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/CompositeSourceContainer.java5
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DefaultSourceContainer.java11
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DirectorySourceContainer.java7
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ExternalArchiveSourceContainer.java9
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/FolderSourceContainer.java9
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ProjectSourceContainer.java8
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/WorkspaceSourceContainer.java7
-rw-r--r--org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/containers/ContainerSourceContainer.java (renamed from org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ContainerSourceContainer.java)4
-rw-r--r--org.eclipse.debug.core/schema/sourceContainerTypes.exsd12
-rw-r--r--org.eclipse.debug.core/schema/sourcePathComputers.exsd10
20 files changed, 111 insertions, 56 deletions
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java
index 8f2c60c82..2e986321a 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java
@@ -17,9 +17,7 @@ import org.eclipse.debug.core.model.IPersistableSourceLocator;
/**
* Extensions to the <code>IPersistableSourceLocator</code> interface.
- * <p>
- * This class is yet experimental.
- * </p>
+ *
* @see org.eclipse.debug.core.model.IPersistableSourceLocator
* @since 3.0
*/
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java
index 3af33caa7..b788d8963 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java
@@ -20,9 +20,18 @@ package org.eclipse.debug.core.sourcelookup;
* <p>
* A source container type is contributed via the <code>sourceContainerTypes</code>
* extension point, providing a delegate to the work specific to the contributed
- * type.
+ * type. Following is an example contribution.
+ * <pre>
+ * &lt;extension point=&quot;org.eclipse.debug.core.sourceContainerTypes&quot;&gt;
+ * &lt;sourceContainerType
+ * name=&quot;Project&quot;
+ * class=&quot;org.eclipse.debug.internal.core.sourcelookup.containers.ProjectSourceContainerType&quot;
+ * id=&quot;org.eclipse.debug.core.containerType.project&quot;
+ * description=&quot;A project in the workspace&quot;&gt;
+ * &lt;/sourceContainerType&gt;
+ * &lt;/extension&gt;
+ * </pre>
* </p>
- *
* @see org.eclipse.debug.core.sourcelookup.ISourceContainer
* @see org.eclipse.debug.core.sourcelookup.ISourceContainerTypeDelegate
* @since 3.0
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java
index 0d048b0b9..75ca4a2ba 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java
@@ -21,9 +21,9 @@ import org.eclipse.core.runtime.CoreException;
* A source container type delegate is contributed via the
* <code>sourceContainerTypes</code> extension point.
* </p>
- *
- * TODO: example plug-in XML definition/description
- *
+ * <p>
+ * Clients may implement this interface.
+ * </p>
* @see org.eclipse.debug.core.sourcelookup.ISourceContainer
* @see org.eclipse.debug.core.sourcelookup.ISourceContainerType
* @since 3.0
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java
index 31a64899d..5cc46ab9a 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java
@@ -16,7 +16,11 @@ import org.eclipse.debug.core.ILaunchConfiguration;
/**
* A source lookup director directs the source lookup process
* among a set of participants and source containers.
- *
+ * <p>
+ * Clients may implement this interface. An astract implementation
+ * is provided by <code>AbstractSourceLookupDirector</code>, which
+ * clients should subclass.
+ * </p>
* @since 3.0
*/
public interface ISourceLookupDirector extends IPersistableSourceLocator2 {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java
index a69c26960..c5edd75b8 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java
@@ -22,7 +22,11 @@ import org.eclipse.core.runtime.CoreException;
* (<code>ISourceContainer</code>), to search for source elements. Source containers
* are generally debug model independant, whereas source lookup participants are
* debug model specific.
- *
+ * <p>
+ * Clients may implement this interface. An abstract implementation is
+ * provided by <code>AbstractSourceLookupParticipant</code>, which clients
+ * should subclass.
+ * </p>
* @since 3.0
*/
public interface ISourceLookupParticipant {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java
index 5f484d8a7..1bb666cce 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java
@@ -18,12 +18,17 @@ import org.eclipse.debug.core.DebugPlugin;
* <p>
* A source path computer is contributed in plug-in XML via the
* <code>sourcePathComputers</code> extension point, that provides a delegate
- * to compute the path specific to a launch configuration.
- * </p>
- *
- * TODO: Didn't we also want to be able to override the registered computer
- * with a configuration attribute?
- *
+ * to compute the path specific to a launch configuration. Following
+ * is an example contribution.
+ * <pre>
+ * &lt;extension point=&quot;org.eclipse.debug.core.sourcePathComputers&quot;&gt;
+ * &lt;sourcePathComputer
+ * id=&quot;org.eclipse.example.exampleSourcePathComputer&quot;
+ * class=&quot;org.eclipse.example.SourcePathComputer&quot;&gt;
+ * &lt;/sourcePathComputer&gt;
+ * &lt;/extension&gt;
+ * </pre>
+ * </p>
* @since 3.0
*/
public interface ISourcePathComputer extends ISourcePathComputerDelegate {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java
index 2fa0887d8..c65ec91c9 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java
@@ -15,25 +15,19 @@ import org.eclipse.core.runtime.IProgressMonitor;
import org.eclipse.debug.core.ILaunchConfiguration;
/**
- * A source path computer computes the default source lookup path (set of source
- * containers that should be considered) for a launch configuration.
+ * A source path computer delegate computes the default source lookup path
+ * (set of source containers that should be considered) for a launch
+ * configuration.
* <p>
* A source path computer is contributed in plug-in XML via the
* <code>sourcePathComputers</code> extension point, providing a delegate
- * to compute the default source lookup path specific to a launch configuration.
+ * to compute the default source lookup path specific to a launch
+ * configuration.
* </p>
- * <pre>
- * <extension point="org.eclipse.debug.core.sourcePathComputers">
- * <sourcePathComputer
- * id="com.example.debug.pdt.PDTSourcePathComputer"
- * class="com.example.debug.pdt.PDTSourcePathComputer">
- * </sourcePathComputer>
- * </extension>
- * </pre>
- *
- * TODO: Didn't we also want to be able to override the registered computer
- * with a configuration attribute?
- *
+ * <p>
+ * Clients may implement this interface.
+ * </p>
+ * @see org.eclipse.debug.core.sourcelookup.ISourcePathComputer
* @since 3.0
*/
public interface ISourcePathComputerDelegate {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainer.java
index 19201c7f9..09c40c345 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainer.java
@@ -24,7 +24,7 @@ import org.eclipse.debug.core.sourcelookup.ISourceLookupDirector;
* <p>
* Clients implementing source containers should subclass this class.
* </p>
- * @sicne 3.0
+ * @since 3.0
*/
public abstract class AbstractSourceContainer extends PlatformObject implements ISourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java
index e52aa4d85..9d07e21c9 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java
@@ -23,7 +23,7 @@ import org.w3c.dom.Element;
* <p>
* Clients implementing source container delegates should subclass this class.
* </p>
- * @sicne 3.0
+ * @since 3.0
*/
public abstract class AbstractSourceContainerTypeDelegate implements ISourceContainerTypeDelegate {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ArchiveSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ArchiveSourceContainer.java
index bdc8166fa..1395412d4 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ArchiveSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ArchiveSourceContainer.java
@@ -17,7 +17,10 @@ import org.eclipse.debug.core.sourcelookup.ISourceContainerType;
/**
* Archive source container for an archive in the workspace. Returns instances
* of <code>ZipEntryStorage</code> as source elemetns.
- *
+ * <p>
+ * Clients may instantiate this class. This class is not intended to
+ * be subclassed.
+ * </p>
* @since 3.0
*/
public class ArchiveSourceContainer extends ExternalArchiveSourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/CompositeSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/CompositeSourceContainer.java
index 5e5535e93..87e23adbd 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/CompositeSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/CompositeSourceContainer.java
@@ -21,7 +21,10 @@ import org.eclipse.debug.internal.core.sourcelookup.SourceLookupMessages;
/**
* A source container of source containers.
- *
+ * <p>
+ * Clients implementing composite source containers should subclass
+ * this class.
+ * </p>
* @since 3.0
*/
public abstract class CompositeSourceContainer extends AbstractSourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DefaultSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DefaultSourceContainer.java
index 169168983..f3f5c6b82 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DefaultSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DefaultSourceContainer.java
@@ -20,10 +20,13 @@ import org.eclipse.debug.core.sourcelookup.ISourcePathComputer;
import org.eclipse.debug.internal.core.sourcelookup.SourceLookupMessages;
/**
- * A source container that can be used as the root container for default source containers.
- * Listens to the configuration file and marks itself as dirty when changes have occurred.
- * When dirty, it will refresh it's children before the next time it is searched or displayed.
- *
+ * A source container that computers the default source lookup path
+ * for a launch configuration on each launch using a launch configuration's
+ * associated source path computer.
+ * <p>
+ * Clients may instantiate this class. This class is not intended to
+ * be subclassed.
+ * </p>
* @since 3.0
*/
public class DefaultSourceContainer extends CompositeSourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DirectorySourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DirectorySourceContainer.java
index 84b19bb80..a6d85e83c 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DirectorySourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/DirectorySourceContainer.java
@@ -20,10 +20,13 @@ import org.eclipse.debug.core.sourcelookup.ISourceContainer;
import org.eclipse.debug.core.sourcelookup.ISourceContainerType;
/**
- * A folder in the local file system. Source elements returned
+ * A directory in the local file system. Source elements returned
* from <code>findSourceElements(...)</code> are instances
* of <code>LocalFileStorage</code>.
- *
+ * <p>
+ * Clients may instantiate this class. This class is not intended to
+ * be subclassed.
+ * </p>
* @since 3.0
*/
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ExternalArchiveSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ExternalArchiveSourceContainer.java
index 770144866..d84f291a1 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ExternalArchiveSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ExternalArchiveSourceContainer.java
@@ -24,9 +24,12 @@ import org.eclipse.debug.internal.core.sourcelookup.SourceLookupMessages;
import org.eclipse.debug.internal.core.sourcelookup.SourceLookupUtils;
/**
- * Archive source container. Returns instances of <code>ZipEntryStorage</code>
- * as source elemetns.
- *
+ * An archive in the local file system. Returns instances
+ * of <code>ZipEntryStorage</code> as source elemetns.
+ * <p>
+ * Clients may instantiate this class. This class is not intended to
+ * be subclassed.
+ * </p>
* @since 3.0
*/
public class ExternalArchiveSourceContainer extends AbstractSourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/FolderSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/FolderSourceContainer.java
index 12d4dc694..3310f9f31 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/FolderSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/FolderSourceContainer.java
@@ -13,11 +13,14 @@ package org.eclipse.debug.core.sourcelookup.containers;
import org.eclipse.core.resources.IContainer;
import org.eclipse.debug.core.DebugPlugin;
import org.eclipse.debug.core.sourcelookup.ISourceContainerType;
+import org.eclipse.debug.internal.core.sourcelookup.containers.*;
/**
- * A folder in the workspace. Source elements are searched
- * for within a folder and its nested folders.
- *
+ * A folder in the workspace.
+ * <p>
+ * Clients may instantiate this class. This class is not intended to
+ * be subclassed.
+ * </p>
* @since 3.0
*/
public class FolderSourceContainer extends ContainerSourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ProjectSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ProjectSourceContainer.java
index d2422ad35..b03b64514 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ProjectSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ProjectSourceContainer.java
@@ -17,14 +17,16 @@ import org.eclipse.core.runtime.CoreException;
import org.eclipse.debug.core.DebugPlugin;
import org.eclipse.debug.core.sourcelookup.ISourceContainer;
import org.eclipse.debug.core.sourcelookup.ISourceContainerType;
+import org.eclipse.debug.internal.core.sourcelookup.containers.*;
/**
* A project in the workspace. Source is searched for in the root project
* folder and all folders within the project recursively. Optionally,
* referenced projects may be searched as well.
- *
- * TODO: need project browser/workbench adapter
- *
+ * <p>
+ * Clients may instantiate this class. This class is not intended to
+ * be subclassed.
+ * </p>
* @since 3.0
*/
public class ProjectSourceContainer extends ContainerSourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/WorkspaceSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/WorkspaceSourceContainer.java
index 59b434817..786a55ecd 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/WorkspaceSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/WorkspaceSourceContainer.java
@@ -20,9 +20,10 @@ import org.eclipse.debug.internal.core.sourcelookup.SourceLookupMessages;
/**
* All projects in the workspace.
- *
- * TODO: need workspace browser/workbench adapter
- *
+ * <p>
+ * Clients may instantiate this class. This class is not intended to
+ * be subclassed.
+ * </p>
* @since 3.0
*/
public class WorkspaceSourceContainer extends CompositeSourceContainer {
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ContainerSourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/containers/ContainerSourceContainer.java
index 47d3eb9c6..bc46007eb 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/ContainerSourceContainer.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/containers/ContainerSourceContainer.java
@@ -8,7 +8,7 @@
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
-package org.eclipse.debug.core.sourcelookup.containers;
+package org.eclipse.debug.internal.core.sourcelookup.containers;
import java.util.ArrayList;
import java.util.List;
@@ -20,6 +20,8 @@ import org.eclipse.core.runtime.CoreException;
import org.eclipse.core.runtime.IPath;
import org.eclipse.core.runtime.Path;
import org.eclipse.debug.core.sourcelookup.ISourceContainer;
+import org.eclipse.debug.core.sourcelookup.containers.CompositeSourceContainer;
+import org.eclipse.debug.core.sourcelookup.containers.FolderSourceContainer;
/**
* A container in the workspace. Source elements are searched
diff --git a/org.eclipse.debug.core/schema/sourceContainerTypes.exsd b/org.eclipse.debug.core/schema/sourceContainerTypes.exsd
index e6a4e2f57..6895bb580 100644
--- a/org.eclipse.debug.core/schema/sourceContainerTypes.exsd
+++ b/org.eclipse.debug.core/schema/sourceContainerTypes.exsd
@@ -90,7 +90,17 @@
<meta.section type="examples"/>
</appInfo>
<documentation>
-
+ The following is an example of a source container type definition:
+&lt;pre&gt;
+&lt;extension point=&quot;org.eclipse.debug.core.sourceContainerTypes&quot;&gt;
+ &lt;sourceContainerType
+ name=&quot;Project&quot;
+ class=&quot;org.eclipse.debug.internal.core.sourcelookup.containers.ProjectSourceContainerType&quot;
+ id=&quot;org.eclipse.debug.core.containerType.project&quot;
+ description=&quot;A project in the workspace&quot;&gt;
+ &lt;/sourceContainerType&gt;
+&lt;/extension&gt;
+&lt;/pre&gt;
</documentation>
</annotation>
diff --git a/org.eclipse.debug.core/schema/sourcePathComputers.exsd b/org.eclipse.debug.core/schema/sourcePathComputers.exsd
index 100e5a1e0..ad585f8ff 100644
--- a/org.eclipse.debug.core/schema/sourcePathComputers.exsd
+++ b/org.eclipse.debug.core/schema/sourcePathComputers.exsd
@@ -84,7 +84,15 @@
<meta.section type="examples"/>
</appInfo>
<documentation>
-
+ Following is an example source path computer definition:
+&lt;pre&gt;
+ &lt;extension point=&quot;org.eclipse.debug.core.sourcePathComputers&quot;&gt;
+ &lt;sourcePathComputer
+ id=&quot;org.eclipse.example.exampleSourcePathComputer&quot;
+ class=&quot;org.eclipse.example.SourcePathComputer&quot;&gt;
+ &lt;/sourcePathComputer&gt;
+ &lt;/extension&gt;
+&lt;/pre&gt;
</documentation>
</annotation>

Back to the top