From: Simon Brandhof <simon.brandhof@sonarsource.com>
Date: Mon, 12 May 2014 22:51:20 +0000 (+0200)
Subject: SONAR-5283 improve javadoc
X-Git-Tag: 4.4-RC1~1116
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=0fe25123678e29293ac6d5cc8a7973c5c0cda2ca;p=sonarqube.git

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 bedc2e9162f..2b73f9971cf 100644
--- 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 {