fixing broken jdocs links, adding source generator and jdoc generator

Author: SimplyProgrammer

SerialX-core/src/main/java/org/ugp/serialx/Scope.java

@@ -93,7 +93,7 @@ public Scope(GenericScope<String, ?> sourceScope)
 	/**
 	 * @param variablesMap | Initial variables to be added in to this scope!
 	 * @param values | Initial independent values to be added in to this scope!
-	 * @param | Parent of this scope.
+	 * @param parent | Parent of this scope.
 
 	 * @since 1.3.5
 	 */
@@ -103,7 +103,7 @@ public Scope(Map<String, ?> variablesMap, Collection<?> values, GenericScope<?,
 	}
 
 	@Override
-	public Scope clone() 
+	public Scope clone()
 	{
 		try 
 		{

SerialX-core/src/main/java/org/ugp/serialx/Utils.java

@@ -142,7 +142,7 @@ public static Object InvokeFunc(Object obj, String name, Object... args) throws
 
 	/**
 	 * @param obj | The object the underlying method is invoked from!
-	 * @param cls | Class to invoke method from.
+	 * @param objCls | Class to invoke method from.
 	 * @param name | Name of public static method to be called.
 	 * @param args | Arguments of method. Arguments should be certain if method is overloaded!
 	 * 
@@ -165,7 +165,7 @@ public static Object InvokeFunc(Object obj, Class<?> objCls, String name, Object
 
 	/**
 	 * @param obj | The object the underlying method is invoked from!
-	 * @param cls | Class to invoke method from.
+	 * @param objCls | Class to invoke method from.
 	 * @param name | Name of public static method to be called.
 	 * @param argClasses | Classes of args.
 	 * @param args | Arguments of method. Arguments should be certain if method is overloaded!
@@ -447,8 +447,8 @@ public static StringBuilder multilpy(char ch, int times)
 	}
 
 	/**
-	 * @param ch | String to multiply!
-	 * @param str | Count of multiplication!
+	 * @param str | String to multiply!
+	 * @param times | Count of multiplication!
 	 * 
 	 * @return Multiplied char, for example <code>multilpy("a", 5)</code> will return "aaaaa";
 	 * 

SerialX-core/src/main/java/org/ugp/serialx/converters/ProtocolConverter.java

@@ -164,9 +164,9 @@ protected Object parse(ParserRegistry myHomeRegistry, Class<?> objClass, String
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Object... args)
+	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args)
 	{
-		return toString(myHomeRegistry, arg, null, args);
+		return toString(myHomeRegistry, obj, null, args);
 	}
 
 	/**
@@ -181,15 +181,15 @@ public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Object..
 	 * @since 1.3.5
 	 */
 	@SuppressWarnings("unchecked")
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, SerializationProtocol<Object> preferedProtocol, Object... args) 
+	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, SerializationProtocol<Object> preferedProtocol, Object... args) 
 	{
-		if (arg == null)
+		if (obj == null)
 			return CONTINUE;
 
-		if (useBase64IfCan && arg instanceof Serializable)
+		if (useBase64IfCan && obj instanceof Serializable)
 			return CONTINUE;
 
-		if (preferedProtocol != null || (preferedProtocol = (SerializationProtocol<Object>) getProtocolFor(arg, SerializationProtocol.MODE_SERIALIZE, args)) != null)
+		if (preferedProtocol != null || (preferedProtocol = (SerializationProtocol<Object>) getProtocolFor(obj, SerializationProtocol.MODE_SERIALIZE, args)) != null)
 		{
 			Class<?> oldObjectClass = null;
 			try
@@ -200,10 +200,10 @@ public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Serializ
 				if (args.length < 5)
 					args = Arrays.copyOf(args, 5);
 				oldObjectClass = (Class<?>) args[4];
-				args[4] = arg.getClass();;
+				args[4] = obj.getClass();;
 
-				Object[] objArgs = preferedProtocol.serialize(arg);
-				StringBuilder sb = new StringBuilder(ImportsProvider.getAliasFor(args.length > 0 ? args[0] : null, arg.getClass()) + (objArgs.length <= 0 ? "" : " "));
+				Object[] objArgs = preferedProtocol.serialize(obj);
+				StringBuilder sb = new StringBuilder(ImportsProvider.getAliasFor(args.length > 0 ? args[0] : null, obj.getClass()) + (objArgs.length <= 0 ? "" : " "));
 
 				args = args.clone();
 				for (int i = 0, sizeEndl = 10000; i < objArgs.length; i++) 
@@ -229,7 +229,7 @@ public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Serializ
 			}
 			catch (Exception e)
 			{
-				LogProvider.instance.logErr("Exception while serializing instance of \"" + arg.getClass().getName() + "\":", e);
+				LogProvider.instance.logErr("Exception while serializing instance of \"" + obj.getClass().getName() + "\":", e);
 				e.printStackTrace();
 			}
 			args[4] = oldObjectClass;

SerialX-core/src/main/java/org/ugp/serialx/converters/imports/ImportsProvider.java

@@ -196,7 +196,7 @@ public Imports(Collection<? extends Import> c)
 		/**
 		 * Constructs an {@link Imports} with inserted imports.
 		 * 
-		 * @param parsers | Initial content of registry.
+		 * @param imports | Initial content of registry.
 		 * 
 		 * @since 1.3.5
 		 */

SerialX-devtools/src/main/java/org/ugp/serialx/devtools/SerializationDebugger.java

@@ -169,7 +169,7 @@ public static <T extends Serializer> T debug(T serializer)
 
 	/**
 	 * @param serializer | Serializer to debug!
-	 * @param debuger | Specific debugger to use!
+	 * @param debugger | Specific debugger to use!
 	 * 
 	 * @return Serializer capable of debugging its serialization and deserialization!
 	 * 

SerialX-json/src/main/java/org/ugp/serialx/json/JsonSerializer.java

@@ -229,7 +229,7 @@ public <A extends Appendable> A SerializeAsSubscope(A source, Object... args) th
 	}
 
 	/**
-	 * @param jsonSerializer | JsonSerializer to create {@link JussSerializer} from!
+	 * @param jussSerializer | JussSerializer to create {@link JsonSerializer} from!
 	 * 
 	 * @return JussSerializer created from JsonSerializer, all values and variables will remain intact!
 	 * 

SerialX-juss/src/main/java/org/ugp/serialx/juss/JussSerializer.java

@@ -388,7 +388,7 @@ public Appendable GenerateComment(Appendable source, ParserRegistry registry, Ob
 
 	/**
 	 * @param reader | Reader to read from!
-	 * @param formatingArgs | Additional arguments to use. In case of JussSerializer, this should be array of length 4 with 0. argument will being this pointer of this scope (it can be also boolean signifying if formating is required), 1. and 2. argument are null (they are used by JUSS parsers) and argument 3. will be {@link ProtocolRegistry} used by this {@link Serializer}, and additional argument 4. being of type {@link Class} containing information about class that is curently being serialized (used primarily by {@link ObjectConverter}).
+	 * @param args | Additional arguments to use. In case of JussSerializer, this should be array of length 4 with 0. argument will being this pointer of this scope (it can be also boolean signifying if formating is required), 1. and 2. argument are null (they are used by JUSS parsers) and argument 3. will be {@link ProtocolRegistry} used by this {@link Serializer}, and additional argument 4. being of type {@link Class} containing information about class that is curently being serialized (used primarily by {@link ObjectConverter}).
 	 * 
 	 * @return This scope after loading data from reader (you most likely want to return "this")!
 	 * 
@@ -673,21 +673,21 @@ protected Object parseObject(ParserRegistry registry, String str, Object... pars
 	}
 
 	/**
-	 * @param variable | Variable to clone!
+	 * @param variableKey | Variable to clone!
 	 * 
 	 * @return Clone of value stored by variable with inserted name or null if there is no such a one!
 	 * <br><br>
 	 * Note: Cloning is done by {@link Serializer#Clone(Object, Registry, Object[], Object...))}!
 	 * 
 	 * @since 1.3.2
 	 */
-	public <T> T cloneOf(String variableName)
+	public <T> T cloneOf(String variableKey)
 	{
-		return cloneOf(variableName, null);
+		return cloneOf(variableKey, null);
 	}
 
 	/**
-	 * @param variable | Variable to clone!
+	 * @param variableKey | Variable to clone!
 	 * @param defaultValue | Default value to return.
 	 * 
 	 * @return Clone of value stored by variable with inserted name or defaultValue if there is no such a one or given key contains null!
@@ -696,9 +696,9 @@ public <T> T cloneOf(String variableName)
 	 * 
 	 * @since 1.3.2
 	 */
-	public <T> T cloneOf(String variableName, T defaultValue)
+	public <T> T cloneOf(String variableKey, T defaultValue)
 	{
-		T obj = get(variableName, defaultValue);
+		T obj = get(variableKey, defaultValue);
 		if (obj == defaultValue)
 			return defaultValue;
 		return Clone(obj, getParsers(), new Object[] {-99999, 0, this, getProtocols(), isGenerateComments()}, this, null, null, getProtocols());

SerialX-juss/src/main/java/org/ugp/serialx/juss/converters/ObjectConverter.java

@@ -122,9 +122,9 @@ public Object parse(ParserRegistry myHomeRegistry, String str, Object... compile
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Object... args)
+	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args)
 	{
-		return toString(myHomeRegistry, arg, null, args);
+		return toString(myHomeRegistry, obj, null, args);
 	}
 
 	/**
@@ -139,17 +139,17 @@ public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Object..
 	 * @since 1.3.5
 	 */
 	@SuppressWarnings("unchecked")
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, SerializationProtocol<Object> preferedProtocol, Object... args) 
+	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, SerializationProtocol<Object> preferedProtocol, Object... args) 
 	{
-		if (arg instanceof Scope)
+		if (obj instanceof Scope)
 		{
 			Serializer serializer;
 			try
 			{
-				if (arg instanceof Serializer)
-					serializer = (Serializer) arg;
+				if (obj instanceof Serializer)
+					serializer = (Serializer) obj;
 				else if (args.length > 0 && args[0] instanceof Serializer)
-					(serializer = ((Serializer) args[0]).emptyClone()).addAll((GenericScope<String, ?>) arg);
+					(serializer = ((Serializer) args[0]).emptyClone()).addAll((GenericScope<String, ?>) obj);
 				else
 					serializer = getPreferredSerializer();
 			}
@@ -182,7 +182,7 @@ else if (args.length > 0 && args[0] instanceof Serializer)
 			}
 		}
 
-		return super.toString(myHomeRegistry, arg, preferedProtocol, args);
+		return super.toString(myHomeRegistry, obj, preferedProtocol, args);
 	}
 
 	@Override

SerialX-operators/src/main/java/org/ugp/serialx/converters/operators/ArithmeticOperators.java

@@ -23,7 +23,7 @@
 public class ArithmeticOperators implements DataParser
 {
 	/**
-	 * @deprecated DO NOT USE! USE {@link ArithmeticOperators#evalOperator(Object, String, Object)} AND {@link ArithmeticOperators#getOperatorPriority(String)} INSTEAD!
+	 * @deprecated DO NOT USE! USE {@link ArithmeticOperators#operator(Object, String, Object)} AND {@link ArithmeticOperators#getOperatorPriority(String)} INSTEAD!
 	 */
 	@Deprecated
 	protected String[] priority1Oprs = {"*", "*-", "/", "/-", "%"}, priority2Oprs = {"**", "**-"};

SerialX-operators/src/main/java/org/ugp/serialx/converters/operators/ConditionalAssignmentOperators.java

@@ -58,7 +58,7 @@ public Object parse(ParserRegistry myHomeRegistry, String str, Object... args)
 	/**
 	 * @param str | Source string to search.
 	 * @param defaultCountOfConfitions | How many condition operators (tenraryTokens[0]) are expected. Should be 1 in most cases.
-	 * @param tenraryTokens | Characters representing parts of ternary operator. Index 0 should be '?' and index 1 should be ':'.
+	 * @param ternaryOperators | Characters representing parts of ternary operator. Index 0 should be '?' and index 1 should be ':'.
 	 * 
 	 * @return Return index of else branch in ternary operator expression or -1 if there is no else branch!
 	 *