# HG changeset patch
# User Doug Simon <doug.simon@oracle.com>
# Date 1351518080 -3600
# Node ID a3eb814ea564d283c46abd7413749b10618610a6
# Parent  adb3879ffbe2e686b160fa094ec2cd9f984a5520
added more javadoc to DebugConfig interface

diff -r adb3879ffbe2 -r a3eb814ea564 graal/com.oracle.graal.debug/src/com/oracle/graal/debug/Debug.java
--- a/graal/com.oracle.graal.debug/src/com/oracle/graal/debug/Debug.java	Fri Oct 26 17:32:57 2012 +0200
+++ b/graal/com.oracle.graal.debug/src/com/oracle/graal/debug/Debug.java	Mon Oct 29 14:41:20 2012 +0100
@@ -189,7 +189,7 @@
         }
     }
 
-    public static DebugConfig fixedConfig(final boolean isLogEnabled, final boolean isDumpEnabled, final boolean isMeterEnabled, final boolean isTimerEnabled, final Collection<? extends DebugDumpHandler> dumpHandlers, final PrintStream output) {
+    public static DebugConfig fixedConfig(final boolean isLogEnabled, final boolean isDumpEnabled, final boolean isMeterEnabled, final boolean isTimerEnabled, final Collection<DebugDumpHandler> dumpHandlers, final PrintStream output) {
         return new DebugConfig() {
 
             @Override
@@ -218,7 +218,7 @@
             }
 
             @Override
-            public Collection< ? extends DebugDumpHandler> dumpHandlers() {
+            public Collection<DebugDumpHandler> dumpHandlers() {
                 return dumpHandlers;
             }
 
diff -r adb3879ffbe2 -r a3eb814ea564 graal/com.oracle.graal.debug/src/com/oracle/graal/debug/DebugConfig.java
--- a/graal/com.oracle.graal.debug/src/com/oracle/graal/debug/DebugConfig.java	Fri Oct 26 17:32:57 2012 +0200
+++ b/graal/com.oracle.graal.debug/src/com/oracle/graal/debug/DebugConfig.java	Mon Oct 29 14:41:20 2012 +0100
@@ -65,9 +65,18 @@
      */
     boolean isTimeEnabled();
 
+    /**
+     * Handles notification of an exception occurring within a debug scope.
+     *
+     * @return the exception object that is to be propagated to parent scope. A value of {@code null} indicates that
+     *         {@code e} is to be propagated.
+     */
     RuntimeException interceptException(Throwable e);
 
-    Collection<? extends DebugDumpHandler> dumpHandlers();
+    /**
+     * Gets the modifiable collection dump handlers registered with this configuration.
+     */
+    Collection<DebugDumpHandler> dumpHandlers();
 
     PrintStream output();
 }
diff -r adb3879ffbe2 -r a3eb814ea564 graal/com.oracle.graal.hotspot/src/com/oracle/graal/hotspot/HotSpotDebugConfig.java
--- a/graal/com.oracle.graal.hotspot/src/com/oracle/graal/hotspot/HotSpotDebugConfig.java	Fri Oct 26 17:32:57 2012 +0200
+++ b/graal/com.oracle.graal.hotspot/src/com/oracle/graal/hotspot/HotSpotDebugConfig.java	Mon Oct 29 14:41:20 2012 +0100
@@ -177,7 +177,7 @@
     }
 
     @Override
-    public Collection<? extends DebugDumpHandler> dumpHandlers() {
+    public Collection<DebugDumpHandler> dumpHandlers() {
         return dumpHandlers;
     }