EXTSCRIPT-189: fix a lot of jsdoc warnings

git-svn-id: https://svn.apache.org/repos/asf/myfaces/extensions/scripting/trunk@1809542 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/common/util/Null.java b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/common/util/Null.java
index 730835d..a3ce2cb 100644
--- a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/common/util/Null.java
+++ b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/common/util/Null.java
@@ -29,7 +29,7 @@
 
     /**
      * representation of a null value of a specific class
-     * @param clazz
+     * @param clazz the class for the null representation
      */
     public Null(Class clazz) {
         super(clazz, null);
diff --git a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/CompilationResult.java b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/CompilationResult.java
index 6d7c471..0509bcb 100644
--- a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/CompilationResult.java
+++ b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/CompilationResult.java
@@ -55,6 +55,7 @@
      * @param compilerOutput the compiler output, i.e. simply everything that the compiler would
      *                       usually print to the console, if you executed the same process on
      *                       the command line instead
+     *
      */
     public CompilationResult(String compilerOutput) {
         this._compilerOutput = compilerOutput;
@@ -80,7 +81,7 @@
      * <p>Determines whether any error messages have been registered, i.e. whether compilation
      * was successful.</p>
      *
-     * @return <code>true</code if no error messages have been registered, i.e. if compilation
+     * @return <code>true</code> if no error messages have been registered, i.e. if compilation
      *         was sucessful; <code>false</code> otherwise
      */
     public boolean hasErrors() {
diff --git a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/ScriptingEngine.java b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/ScriptingEngine.java
index f55d5fc..6c93b36 100644
--- a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/ScriptingEngine.java
+++ b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/core/engine/api/ScriptingEngine.java
@@ -49,7 +49,7 @@
 
     /**
      * returns the file ending sufficient for this engine
-     * @return
+     * @return the correct file ending for the engine
      */
     public String getFileEnding();
 
@@ -61,18 +61,22 @@
 
     /**
      * runs the compile cycle for this engine
+     *
+     * @return a compilation result for this compile
      */
     public CompilationResult compile();
 
     /**
      * checks if the current engine has tainted classes
-     * @return
+     *
+     * @return true if a resource is tainted
      */
     public boolean isTainted();
 
     /**
      * checks if the current engine has a need for a recompile of certain classes
-     * @return
+     *
+     * @return true if the engine needs a recompile
      */
     public boolean needsRecompile();
 
@@ -120,7 +124,7 @@
 
     /**
      * detects whether a given object is an artifact of a given object
-     * @return
+     * @return true if this artifact belongs to the engine
      */
     public boolean isArtifactOfEngine(Object artifact);
 
diff --git a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/annotation/GenericAnnotationScanner.java b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/annotation/GenericAnnotationScanner.java
index 2be38cb..a9d788a 100644
--- a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/annotation/GenericAnnotationScanner.java
+++ b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/annotation/GenericAnnotationScanner.java
@@ -44,7 +44,7 @@
  *          <p>&nbsp;</p>
  *          Source path annotation scanner for java it scans all sources in the specified source paths
  *          recursively for additional information
- *          and then adds the id/name -> class binding information to the correct factory locations,
+ *          and then adds the id/name -&gt; class binding information to the correct factory locations,
  *          wherever possible
  */
 @SuppressWarnings("unused")
diff --git a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/resources/deprecated/BaseResourceHandlerSupport.java b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/resources/deprecated/BaseResourceHandlerSupport.java
index 6c87697..52d4d5e 100644
--- a/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/resources/deprecated/BaseResourceHandlerSupport.java
+++ b/extscript-core-root/extscript-core/src/main/java/org/apache/myfaces/extensions/scripting/jsf/resources/deprecated/BaseResourceHandlerSupport.java
@@ -143,6 +143,9 @@
     /**
      * Read the web.xml file that is in the classpath and parse its internals to
      * figure out how the FacesServlet is mapped for the current webapp.
+     *
+     * @param context standard faces context
+     * @return the servlet mapping
      */
     protected FacesServletMapping getFacesServletMapping(FacesContext context)
     {