From ed1647b61af0a6d679ffebc0ac69a51be61e337f Mon Sep 17 00:00:00 2001 From: Luc Maisonobe Date: Thu, 17 Jun 2010 18:15:27 +0000 Subject: [PATCH] added missing @since and @deprecated git-svn-id: https://svn.apache.org/repos/asf/commons/proper/math/trunk@955693 13f79535-47bb-0310-9956-ffa450edef68 --- .../apache/commons/math/MathException.java | 3 ++- .../commons/math/MathRuntimeException.java | 19 +++++++++++++++++++ .../math/estimation/EstimationException.java | 1 + .../commons/math/ode/DerivativeException.java | 1 + .../commons/math/ode/IntegratorException.java | 1 + 5 files changed, 24 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/apache/commons/math/MathException.java b/src/main/java/org/apache/commons/math/MathException.java index 85e0579d1..4facae0ea 100644 --- a/src/main/java/org/apache/commons/math/MathException.java +++ b/src/main/java/org/apache/commons/math/MathException.java @@ -78,6 +78,7 @@ public class MathException extends Exception { * Message formatting is delegated to {@link java.text.MessageFormat}. * @param pattern format specifier * @param arguments format arguments + * @since 2.2 */ public MathException(Localizable pattern, Object ... arguments) { this.pattern = pattern; @@ -121,7 +122,7 @@ public class MathException extends Exception { * to be thrown. * @param pattern format specifier * @param arguments format arguments - * @since 1.2 + * @since 2.2 */ public MathException(Throwable rootCause, Localizable pattern, Object ... arguments) { super(rootCause); diff --git a/src/main/java/org/apache/commons/math/MathRuntimeException.java b/src/main/java/org/apache/commons/math/MathRuntimeException.java index 744a5e9f6..ee4f6b443 100644 --- a/src/main/java/org/apache/commons/math/MathRuntimeException.java +++ b/src/main/java/org/apache/commons/math/MathRuntimeException.java @@ -217,7 +217,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createArithmeticException(Localizable, Object...)} */ + @Deprecated public static ArithmeticException createArithmeticException(final String pattern, final Object ... arguments) { return createArithmeticException(new DummyLocalizable(pattern), arguments); @@ -259,7 +261,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createArrayIndexOutOfBoundsException(Localizable, Object...)} */ + @Deprecated public static ArrayIndexOutOfBoundsException createArrayIndexOutOfBoundsException(final String pattern, final Object ... arguments) { return createArrayIndexOutOfBoundsException(new DummyLocalizable(pattern), arguments); @@ -301,7 +305,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createEOFException(Localizable, Object...)} */ + @Deprecated public static EOFException createEOFException(final String pattern, final Object ... arguments) { return createEOFException(new DummyLocalizable(pattern), arguments); @@ -313,6 +319,7 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @since 2.2 */ public static EOFException createEOFException(final Localizable pattern, final Object ... arguments) { @@ -359,7 +366,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createIllegalArgumentException(Localizable, Object...)} */ + @Deprecated public static IllegalArgumentException createIllegalArgumentException(final String pattern, final Object ... arguments) { return createIllegalArgumentException(new DummyLocalizable(pattern), arguments); @@ -414,7 +423,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createIllegalStateException(Localizable, Object...)} */ + @Deprecated public static IllegalStateException createIllegalStateException(final String pattern, final Object ... arguments) { return createIllegalStateException(new DummyLocalizable(pattern), arguments); @@ -456,7 +467,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createConcurrentModificationException(Localizable, Object...)} */ + @Deprecated public static ConcurrentModificationException createConcurrentModificationException(final String pattern, final Object ... arguments) { return createConcurrentModificationException(new DummyLocalizable(pattern), arguments); @@ -498,7 +511,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createNoSuchElementException(Localizable, Object...)} */ + @Deprecated public static NoSuchElementException createNoSuchElementException(final String pattern, final Object ... arguments) { return createNoSuchElementException(new DummyLocalizable(pattern), arguments); @@ -540,7 +555,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createNullPointerException(Localizable, Object...)} */ + @Deprecated public static NullPointerException createNullPointerException(final String pattern, final Object ... arguments) { return createNullPointerException(new DummyLocalizable(pattern), arguments); @@ -584,7 +601,9 @@ public class MathRuntimeException extends RuntimeException { * @param pattern format specifier * @param arguments format arguments * @return built exception + * @deprecated as of 2.2 replaced by {@link #createParseException(int, Localizable, Object...)} */ + @Deprecated public static ParseException createParseException(final int offset, final String pattern, final Object ... arguments) { diff --git a/src/main/java/org/apache/commons/math/estimation/EstimationException.java b/src/main/java/org/apache/commons/math/estimation/EstimationException.java index 25dacafc9..012fe9947 100644 --- a/src/main/java/org/apache/commons/math/estimation/EstimationException.java +++ b/src/main/java/org/apache/commons/math/estimation/EstimationException.java @@ -52,6 +52,7 @@ extends MathException { * Build an exception by translating and formating a message * @param specifier format specifier (to be translated) * @param parts to insert in the format (no translation) + * @since 2.2 */ public EstimationException(Localizable specifier, Object ... parts) { super(specifier, parts); diff --git a/src/main/java/org/apache/commons/math/ode/DerivativeException.java b/src/main/java/org/apache/commons/math/ode/DerivativeException.java index 19fda4e8e..468c1684e 100644 --- a/src/main/java/org/apache/commons/math/ode/DerivativeException.java +++ b/src/main/java/org/apache/commons/math/ode/DerivativeException.java @@ -49,6 +49,7 @@ public class DerivativeException * Build an exception by translating and formating a message * @param specifier format specifier (to be translated) * @param parts to insert in the format (no translation) + * @since 2.2 */ public DerivativeException(final Localizable specifier, final Object ... parts) { super(specifier, parts); diff --git a/src/main/java/org/apache/commons/math/ode/IntegratorException.java b/src/main/java/org/apache/commons/math/ode/IntegratorException.java index f0b9869ba..75d65a47a 100644 --- a/src/main/java/org/apache/commons/math/ode/IntegratorException.java +++ b/src/main/java/org/apache/commons/math/ode/IntegratorException.java @@ -47,6 +47,7 @@ public class IntegratorException * Build an exception by translating and formating a message * @param specifier format specifier (to be translated) * @param parts to insert in the format (no translation) + * @since 2.2 */ public IntegratorException(final Localizable specifier, final Object ... parts) { super(specifier, parts);