Add javadoc to InputFile + improve JavaFile#toString()

2 files changed, 7 insertions, 9 deletions

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/resources/InputFile.java b/sonar-plugin-api/src/main/java/org/sonar/api/resources/InputFile.java
index 4c926f897e1..803dafaee58 100644
--- a/sonar-plugin-api/src/main/java/org/sonar/api/resources/InputFile.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/resources/InputFile.java
@@ -26,6 +26,10 @@ import java.io.File;
  */
 public interface InputFile {
 
+  /**
+   * The source base directory, different than the project basedir. For example in maven projects, the basedir of a source file stored in
+   * src/main/java/org/foo/ is the directory src/main/java.
+   */
   File getFileBaseDir();
 
   File getFile();
@@ -33,10 +37,10 @@ public interface InputFile {
   /**
    * Path relative to basedir. Directory separator is slash '/', whatever the platform.
    * 
-   * Example on windows: if basedir is c:\project\src\ and file is c:\project\src\org\foo\Bar.java, then relative path
+   * Example on windows: if file basedir is c:\project\src\ and file is c:\project\src\org\foo\Bar.java, then relative path
    * is org/foo/Bar.java
    *
-   * Example on unix: if basedir is /project/src and file is /project/src/org/foo/Bar.java, then relative path
+   * Example on unix: if file basedir is /project/src and file is /project/src/org/foo/Bar.java, then relative path
    * is org/foo/Bar.java as well.
    */
   String getRelativePath();
diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/resources/JavaFile.java b/sonar-plugin-api/src/main/java/org/sonar/api/resources/JavaFile.java
index 009a04e670a..dc0f729e9e0 100644
--- a/sonar-plugin-api/src/main/java/org/sonar/api/resources/JavaFile.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/resources/JavaFile.java
@@ -20,7 +20,6 @@
 package org.sonar.api.resources;
 
 import org.apache.commons.lang.StringUtils;
-import org.apache.commons.lang.builder.ToStringBuilder;
 import org.sonar.api.utils.WildcardPattern;
 
 import java.io.File;
@@ -228,12 +227,7 @@ public class JavaFile extends Resource<JavaPackage> {
 
   @Override
   public String toString() {
-    return new ToStringBuilder(this)
-        .append("key", getKey())
-        .append("package", packageKey)
-        .append("longName", longName)
-        .append("unitTest", unitTest)
-        .toString();
+    return getKey();
   }
 
 //  @Override