documentation and comments corrected

Author: verhas

src/main/java/com/scriptbasic/Function.java

@@ -15,7 +15,7 @@
  * <p>
  * Each {@code public static} method that is supposed to be reachable from BASIC
  * should have the annotation {@code @Function}. The implementation of the
- * interface {@see Interpreter} provides method that registers all the such
+ * interface {@link Interpreter} provides method that registers all the such
  * annotated methods of the class specified.
  * 
  * @author Peter Verhas date July 22, 2012
@@ -94,7 +94,7 @@
 
 	/**
 	 * Using this parameter you can specify an alternative method instead of the
-	 * annotated one. See the documentation of {@see #substituteClass()}.
+	 * annotated one. See the documentation of {@link #substituteClass()}.
 	 */
 	String substituteMethod() default "";
 }

src/main/java/com/scriptbasic/classification/Constant.java

@@ -7,7 +7,7 @@
  * Functions that let the BASIC program to access some special constant values
  * should be annotated using this interface as classification parameter.
  * <p>
- * The best example of these functions is the {@see
+ * The best example of these functions is the {@link
  * RuntimeUtility#nullFunction()} that returns a {@code null} values.
  * <p>
  * Functions classified using these value should be considered exceptionally

src/main/java/com/scriptbasic/executors/leftvalues/BasicLeftValue.java

@@ -131,7 +131,7 @@ private static RightValue handleAccessModifier(RightValue variable,
 
     /**
      * Handle variable access modifier in case when the modifier is object field
-     * access. {@see #handleAccessModifier(RightValue, LeftValueModifier,
+     * access. {@link #handleAccessModifier(RightValue, LeftValueModifier,
      * boolean, RightValue)}.
      * 
      * @param variable
@@ -166,7 +166,7 @@ private static RightValue handleObjectFieldAccess(RightValue variable,
 
     /**
      * Handle variable access modifier in case when the modifier is array
-     * element access. {@see #handleAccessModifier(RightValue,
+     * element access. {@link #handleAccessModifier(RightValue,
      * LeftValueModifier, boolean, RightValue)}.
      * 
      * @param variable

src/main/java/com/scriptbasic/executors/rightvalues/BasicArrayValue.java

@@ -21,7 +21,7 @@ public class BasicArrayValue extends AbstractRightValue {
 	 * for extension methods and is not used by the interpreter. This method can
 	 * be used when the array is available from some calculation and it would be
 	 * waste of resource to copy the elements of the array one by one calling
-	 * {@ref #set(Integer, Object)}.
+	 * {@link #set(Integer, Object)}.
 	 * 
 	 * @param array
 	 *            the array

src/main/java/com/scriptbasic/factories/BasicFactory.java

@@ -8,11 +8,11 @@
 import com.scriptbasic.interfaces.FactoryManaged;
 
 /**
- * Implementing the interface {@see com.scriptbasic.interfaces.Factory} this
- * class instantiates the objects using the JDK standard {@see
+ * Implementing the interface {@link com.scriptbasic.interfaces.Factory} this
+ * class instantiates the objects using the JDK standard {@link
  * java.util.ServiceLoader}. A single factory instance will maintain a single
  * instance of each class and subsequent call on the same factory object to the
- * method {@see #get(Class)} will return the same class instance for the same
+ * method {@link #get(Class)} will return the same class instance for the same
  * interface.
  * <p>
  * The implementation also checks that the argument passed to the method is an

src/main/java/com/scriptbasic/factories/FactoryFactory.java

@@ -4,9 +4,9 @@
 import com.scriptbasic.interfaces.Factory;
 
 /**
- * This utility class manages instances of the {@see BasicFactory} class.
+ * This utility class manages instances of the {@link BasicFactory} class.
  * <p>
- * The class {@see BasicFactory} is not singleton, however this class creates a
+ * The class {@link BasicFactory} is not singleton, however this class creates a
  * single instance and manages that single instance.
  * 
  * @author Peter Verhas

src/main/java/com/scriptbasic/factories/FactoryServiceLoader.java

@@ -7,8 +7,8 @@
 import com.scriptbasic.interfaces.Factory;
 
 /**
- * Using the standard {@see java.util.ServiceLoader} this utility class loads a
- * new instance of the implementation of the interface {@see Factory}.
+ * Using the standard {@link java.util.ServiceLoader} this utility class loads a
+ * new instance of the implementation of the interface {@link Factory}.
  * <p>
  * 
  * @author Peter Verhas
@@ -24,12 +24,12 @@ private FactoryServiceLoader() {
 
     /**
      * Load and create a new instance of the implementation of the interface
-     * {@see Factory}. If there are multiple implementations then the first one
+     * {@link Factory}. If there are multiple implementations then the first one
      * will be loaded. (The first as it is loaded by the standard Java
      * ServiceLoader class.)
      * 
-     * @return a new {@see Factory} instance or {@code null} if there is no
-     *         implementation of the interface {@see Factory}.
+     * @return a new {@link Factory} instance or {@code null} if there is no
+     *         implementation of the interface {@link Factory}.
      */
     public static Factory loadFactory() {
         ServiceLoader<Factory> loader = ServiceLoader.load(Factory.class);

src/main/java/com/scriptbasic/factories/SingletonFactoryFactory.java

@@ -5,9 +5,9 @@
 
 /**
  * This utility class manages a single instance of an implementation of the
- * {@see Factory} interface.
+ * {@link Factory} interface.
  * <p>
- * The class {@see BasicFactory} is not singleton, however this class creates a
+ * The class {@link BasicFactory} is not singleton, however this class creates a
  * single instance and manages that single instance.
  * 
  * @author Peter Verhas

src/main/java/com/scriptbasic/factories/ThreadLocalFactoryFactory.java

@@ -7,7 +7,7 @@
  * Implements a factory factory that returns a new instance for each thread.
  * <p>
  * When the thread does not have an instance then the code uses the utility
- * class {@see FactoryFactory} to get a new instance.
+ * class {@link FactoryFactory} to get a new instance.
  * 
  * @author Peter Verhas
  * date Aug 1, 2012

src/main/java/com/scriptbasic/interfaces/Configuration.java

@@ -50,12 +50,12 @@ public interface Configuration extends FactoryManaged {
     String getConfigValue(String key);
 
     /**
-     * Complimentary method calling {@see #getConfigValue(String)} but returning
+     * Complimentary method calling {@link #getConfigValue(String)} but returning
      * the {@code defaultValue} instead of {@code null} if the {@code key} is
      * not configured.
      * 
      * @param key
-     *            the configuration key, same as in {@see
+     *            the configuration key, same as in {@link
      *            #getConfigValue(String)}.
      * @param defaultValue
      *            is the default value string to return if the configuration key