comments
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IDebugModelPresentation.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IDebugModelPresentation.java
index e802ef1..425cabb 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IDebugModelPresentation.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IDebugModelPresentation.java
@@ -159,16 +159,16 @@
String getEditorId(IEditorInput input, Object element);
/**
- * Returns a detailed description of the given value. This allows
- * a presentation to provide extra details about a selected value
- * in the variable detail portion of the variable view. If <code>null</code>
- * is returned, the value's value string is displayed
+ * Computes a detailed description of the given value, reporting
+ * the result to the specified listener. This allows a presentation
+ * to provide extra details about a selected value in the variable detail
+ * portion of the variable view. Since this can be a long-running operation,
+ * the details are reported back to the specified listener asynchronously.
+ * If <code>null</code> is reported, the value's value string is displayed
* (<code>IValue.getValueString()</code>).
*
* @param value the value for which a detailed description
* is required
- * @return detailed description, or <code>null</code> if none
- * is available
*/
void computeDetail(IValue value, IValueDetailListener listener);
diff --git a/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IValueDetailListener.java b/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IValueDetailListener.java
index 9a83b88..9ddd5fd 100644
--- a/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IValueDetailListener.java
+++ b/org.eclipse.debug.ui/ui/org/eclipse/debug/ui/IValueDetailListener.java
@@ -7,6 +7,20 @@
import org.eclipse.debug.core.model.IValue;
+/**
+ * Listener interface for notification of value
+ * details.
+ *
+ * @see IDebugModelPresentation
+ */
+
public interface IValueDetailListener {
+ /**
+ * Notifies this listener that the details for the given
+ * value have been computed as the specified result.
+ *
+ * @param value the value for which the detail is provided
+ * @param result the detailed description of the given value
+ */
public void detailComputed(IValue value, String result);
}
\ No newline at end of file
