From b6712569b762f001cef872a60a0c9e642b28151c Mon Sep 17 00:00:00 2001
From: Pawel Piech <pawel.piech@windriver.com>
Date: Mon, 26 Jul 2010 22:39:53 +0000
Subject: [PATCH] Javadoc addition.

---
 .../debug/ui/sourcelookup/DsfSourceDisplayAdapter.java    | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/dsf/org.eclipse.cdt.dsf.ui/src/org/eclipse/cdt/dsf/debug/ui/sourcelookup/DsfSourceDisplayAdapter.java b/dsf/org.eclipse.cdt.dsf.ui/src/org/eclipse/cdt/dsf/debug/ui/sourcelookup/DsfSourceDisplayAdapter.java
index 8e5c91ec979..0e2de86bba3 100644
--- a/dsf/org.eclipse.cdt.dsf.ui/src/org/eclipse/cdt/dsf/debug/ui/sourcelookup/DsfSourceDisplayAdapter.java
+++ b/dsf/org.eclipse.cdt.dsf.ui/src/org/eclipse/cdt/dsf/debug/ui/sourcelookup/DsfSourceDisplayAdapter.java
@@ -95,12 +95,20 @@ import org.eclipse.ui.texteditor.ITextEditor;
  * - The second "display job" positions and annotates the editor. <br>  
  * - The third clears the old IP annotations when a thread or process has resumed
  * or exited.
+ * </p>
  * <p>
  * The the lookup jobs can run in parallel with the display or the clearing job, 
  * but the clearing job and the display job must not run at the same time.
  * Hence there is some involved logic which ensures that the jobs are run in 
  * proper order.  To avoid race conditions, this logic uses the session's 
  * dispatch thread to synchronize access to the state data of the running jobs.
+ * </p>
+ * <p>
+ * Debuggers can override the default source editor used by the source display
+ * adapter by registering their own ISourcePresentation adapter. 
+ * </p>
+ * 
+ * @see ISourcePresentation
  * 
  * @since 1.0
  */