Bug 1213: Expose InterruptSource, SourcedInterruptedException and InterruptedRuntimeException

- InterruptSource interface declares methods to retrieve
  the source of a Thread.interrupt() call.

- InterruptSource.Thread implements InterruptSource,
  i.e. allows code running within such thread to learn about
  the interrupt source (stack trace).

- SourcedInterruptedException is a InterruptedException specialization
  which may include the source of the causing Thread.interrupt() call.

- InterruptedRuntimeException
  An unchecked RuntimeException propagating an InterruptedException
  where handling of the latter is not desired.
  The causing InterruptedException may be of type SourcedInterruptedException,
  hence a detailed stack trace analysis might be possible.

1 files changed, 4 insertions, 3 deletions

diff --git a/src/java/com/jogamp/common/JogampRuntimeException.java b/src/java/com/jogamp/common/JogampRuntimeException.java
index d33d498..524bb93 100644
--- a/src/java/com/jogamp/common/JogampRuntimeException.java
+++ b/src/java/com/jogamp/common/JogampRuntimeException.java
@@ -28,9 +28,10 @@
 
 package com.jogamp.common;
 
-/** A generic exception for Jogamp errors used throughout the binding
-    as a substitute for {@link RuntimeException}. */
-
+/**
+ * A generic <i>unchecked exception</i> for Jogamp errors used throughout the binding
+ * as a substitute for {@link RuntimeException}.
+ */
 @SuppressWarnings("serial")
 public class JogampRuntimeException extends RuntimeException {
   /** Constructs a JogampRuntimeException object. */