src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignatureException.java

*** 32,43 ****
  
  /**
   * Indicates an exceptional condition that occurred during the XML
   * signature generation or validation process.
   *
!  * <p>An <code>XMLSignatureException</code> can contain a cause: another
!  * throwable that caused this <code>XMLSignatureException</code> to get thrown.
   *
   * @since 1.6
   */
  public class XMLSignatureException extends Exception {
  
--- 32,43 ----
  
  /**
   * Indicates an exceptional condition that occurred during the XML
   * signature generation or validation process.
   *
!  * <p>An {@code XMLSignatureException} can contain a cause: another
!  * throwable that caused this {@code XMLSignatureException} to get thrown.
   *
   * @since 1.6
   */
  public class XMLSignatureException extends Exception {
  
*** 51,150 ****
       * @serial
       */
      private Throwable cause;
  
      /**
!      * Constructs a new <code>XMLSignatureException</code> with
!      * <code>null</code> as its detail message.
       */
      public XMLSignatureException() {
          super();
      }
  
      /**
!      * Constructs a new <code>XMLSignatureException</code> with the specified
       * detail message.
       *
       * @param message the detail message
       */
      public XMLSignatureException(String message) {
          super(message);
      }
  
      /**
!      * Constructs a new <code>XMLSignatureException</code> with the
       * specified detail message and cause.
       * <p>Note that the detail message associated with
!      * <code>cause</code> is <i>not</i> automatically incorporated in
       * this exception's detail message.
       *
       * @param message the detail message
!      * @param cause the cause (A <tt>null</tt> value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public XMLSignatureException(String message, Throwable cause) {
          super(message);
          this.cause = cause;
      }
  
      /**
!      * Constructs a new <code>XMLSignatureException</code> with the specified
       * cause and a detail message of
!      * <code>(cause==null ? null : cause.toString())</code>
       * (which typically contains the class and detail message of
!      * <code>cause</code>).
       *
!      * @param cause the cause (A <tt>null</tt> value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public XMLSignatureException(Throwable cause) {
          super(cause==null ? null : cause.toString());
          this.cause = cause;
      }
  
      /**
!      * Returns the cause of this <code>XMLSignatureException</code> or
!      * <code>null</code> if the cause is nonexistent or unknown.  (The
       * cause is the throwable that caused this
!      * <code>XMLSignatureException</code> to get thrown.)
       *
!      * @return the cause of this <code>XMLSignatureException</code> or
!      *         <code>null</code> if the cause is nonexistent or unknown.
       */
      public Throwable getCause() {
          return cause;
      }
  
      /**
!      * Prints this <code>XMLSignatureException</code>, its backtrace and
       * the cause's backtrace to the standard error stream.
       */
      public void printStackTrace() {
          super.printStackTrace();
          if (cause != null) {
              cause.printStackTrace();
          }
      }
  
      /**
!      * Prints this <code>XMLSignatureException</code>, its backtrace and
       * the cause's backtrace to the specified print stream.
       *
!      * @param s <code>PrintStream</code> to use for output
       */
      public void printStackTrace(PrintStream s) {
          super.printStackTrace(s);
          if (cause != null) {
              cause.printStackTrace(s);
          }
      }
  
      /**
!      * Prints this <code>XMLSignatureException</code>, its backtrace and
       * the cause's backtrace to the specified print writer.
       *
!      * @param s <code>PrintWriter</code> to use for output
       */
      public void printStackTrace(PrintWriter s) {
          super.printStackTrace(s);
          if (cause != null) {
              cause.printStackTrace(s);
--- 51,150 ----
       * @serial
       */
      private Throwable cause;
  
      /**
!      * Constructs a new {@code XMLSignatureException} with
!      * {@code null} as its detail message.
       */
      public XMLSignatureException() {
          super();
      }
  
      /**
!      * Constructs a new {@code XMLSignatureException} with the specified
       * detail message.
       *
       * @param message the detail message
       */
      public XMLSignatureException(String message) {
          super(message);
      }
  
      /**
!      * Constructs a new {@code XMLSignatureException} with the
       * specified detail message and cause.
       * <p>Note that the detail message associated with
!      * {@code cause} is <i>not</i> automatically incorporated in
       * this exception's detail message.
       *
       * @param message the detail message
!      * @param cause the cause (A {@code null} value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public XMLSignatureException(String message, Throwable cause) {
          super(message);
          this.cause = cause;
      }
  
      /**
!      * Constructs a new {@code XMLSignatureException} with the specified
       * cause and a detail message of
!      * {@code (cause==null ? null : cause.toString())}
       * (which typically contains the class and detail message of
!      * {@code cause}).
       *
!      * @param cause the cause (A {@code null} value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public XMLSignatureException(Throwable cause) {
          super(cause==null ? null : cause.toString());
          this.cause = cause;
      }
  
      /**
!      * Returns the cause of this {@code XMLSignatureException} or
!      * {@code null} if the cause is nonexistent or unknown.  (The
       * cause is the throwable that caused this
!      * {@code XMLSignatureException} to get thrown.)
       *
!      * @return the cause of this {@code XMLSignatureException} or
!      *         {@code null} if the cause is nonexistent or unknown.
       */
      public Throwable getCause() {
          return cause;
      }
  
      /**
!      * Prints this {@code XMLSignatureException}, its backtrace and
       * the cause's backtrace to the standard error stream.
       */
      public void printStackTrace() {
          super.printStackTrace();
          if (cause != null) {
              cause.printStackTrace();
          }
      }
  
      /**
!      * Prints this {@code XMLSignatureException}, its backtrace and
       * the cause's backtrace to the specified print stream.
       *
!      * @param s {@code PrintStream} to use for output
       */
      public void printStackTrace(PrintStream s) {
          super.printStackTrace(s);
          if (cause != null) {
              cause.printStackTrace(s);
          }
      }
  
      /**
!      * Prints this {@code XMLSignatureException}, its backtrace and
       * the cause's backtrace to the specified print writer.
       *
!      * @param s {@code PrintWriter} to use for output
       */
      public void printStackTrace(PrintWriter s) {
          super.printStackTrace(s);
          if (cause != null) {
              cause.printStackTrace(s);