changeset 6584:a3eb814ea564

added more javadoc to DebugConfig interface
author Doug Simon <doug.simon@oracle.com>
date Mon, 29 Oct 2012 14:41:20 +0100
parents adb3879ffbe2
children 5c1787a0be00
files graal/com.oracle.graal.debug/src/com/oracle/graal/debug/Debug.java graal/com.oracle.graal.debug/src/com/oracle/graal/debug/DebugConfig.java graal/com.oracle.graal.hotspot/src/com/oracle/graal/hotspot/HotSpotDebugConfig.java
diffstat 3 files changed, 13 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- 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;
             }
 
--- 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();
 }
--- 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;
     }