...

Author: SimplyProgrammer

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

@@ -20,7 +20,7 @@ public interface DataConverter extends DataParser
 	 * @param args | Some additional args. This can be anything and it demands on implementation of DataConverter. Default SerialX API implementation will provide some flags about formating (2 ints)!
 	 * 
 	 * @return Object converted to string. Easiest way to do this is obj.toString() but you most likely want some more sofisticated formating.
-	 * Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+	 * <br>Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
 	 * 
 	 * @since 1.3.0
 	 */
@@ -44,7 +44,8 @@ default CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object.
 	 * @param args | Some additional args. This can be anything and it demands on implementation of DataConverter. Default SerialX API implementation will provide some flags about formating (2 ints)!
 	 * 
 	 * @return The source appendable after stringified object (obj) was appropriately appended into it. Alternatively you can return null to signify error or that everything necessary was already appended and no further chars should be appended immediately after this obj's stringification.
-	 * Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+	 * <br>Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+	 * <br>Note: It is highly discouraged to append into this return!
 	 * 
 	 * @throws IOException When appending into source throws it... 
 	 * 

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

@@ -34,7 +34,7 @@ public interface DataParser
 	 * 
 	 * @since 1.3.0
 	 */
-	public static final Appendable CONTINUE = new StringBuilder();
+	public static final Appendable CONTINUE = new StringBuilder(0);
 
 	/**
 	 * This is DataParser registry. Here your parser implementations should be registered in order to work properly!
@@ -186,7 +186,8 @@ public CharSequence toString(Object obj, Object... args)
 		 * @param args | Additional arguments that will be obtained in {@link DataParser#toString(String, Object...)}!
 		 * 
 		 * @return The source appendable after stringified object (obj) was appropriately appended into it. Alternatively you can return null to signify error or that everything necessary was already appended and no further chars should be appended immediately after this obj's stringification.
-		 * Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+		 * <br>Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+		 * <br>Note: It is highly discouraged to append into this return!
 		 * 
 		 * @throws IOException When appending into source throws it... 
 		 * 

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

@@ -179,8 +179,7 @@ public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Obj
 	 * @param preferedProtocol | Protocol to use preferably.
 	 * @param args | Some additional args. This can be anything and it demands on implementation of DataConverter. Default SerialX API implementation will provide some flags about formating (2 ints)!
 	 * 
-	 * @return The source appendable after stringified object (obj) was appropriately appended into it. Alternatively you can return null to signify error or that everything necessary was already appended and no further chars should be appended immediately after this obj's stringification.
-	 * Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+	 * @return In accordance with {@link DataConverter#toString(Appendable, org.ugp.serialx.converters.DataParser.ParserRegistry, Object, Object...)}.
 	 * 
 	 * @since 1.3.5
 	 */