SONAR-5283 improve javadoc

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/utils/SonarException.java b/sonar-plugin-api/src/main/java/org/sonar/api/utils/SonarException.java
index bedc2e9162fb8b886ce6ed9e18bdc57feca68e57..2b73f9971cf33c845b0d9913aad6b0e5981115ad 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/utils/SonarException.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/utils/SonarException.java
@@ -21,8 +21,11 @@ package org.sonar.api.utils;
 
 /**
  * Because we don't like checked exceptions !
+ *
  * @since 1.10
- * @deprecated since 4.4. See SONAR-5283
+ * @deprecated in 4.4. Use standard exceptions like {@link java.lang.IllegalArgumentException}
+ * or {@link java.lang.IllegalStateException}. Use {@link org.sonar.api.utils.MessageException}
+ * for raising errors to end-users without displaying stackstrace.
  */
 @Deprecated
 public class SonarException extends RuntimeException {