[jOOQ/jOOQ#11472] Document immutability of CSVFormat and related types

jOOQ/src/main/java/org/jooq/CSVFormat.java

@@ -41,6 +41,9 @@ import static org.jooq.CSVFormat.Quote.SPECIAL_CHARACTERS;
 
 /**
  * A CSV formatting type, which can be used to configure CSV imports / exports.
+ * <p>
+ * The type is immutable, meaning calls to setters like {@link #delimiter(char)}
+ * do not modify the original reference, but return a new one instead.
  *
  * @author Lukas Eder
  */

jOOQ/src/main/java/org/jooq/ChartFormat.java

@@ -40,6 +40,11 @@ package org.jooq;
 import java.text.DecimalFormat;
 
 /**
+ * A CSV formatting type, which can be used to configure chart exports.
+ * <p>
+ * The type is immutable, meaning calls to setters like {@link #width(int)} do
+ * not modify the original reference, but return a new one instead.
+ *
  * @author Lukas Eder
  */
 public final class ChartFormat {

jOOQ/src/main/java/org/jooq/JSONFormat.java

@@ -60,6 +60,9 @@ import static org.jooq.tools.StringUtils.rightPad;
  * or, using {@link RecordFormat#OBJECT}: <code><pre>
  * [{"field-1": value-1-1, "field-2": value-1-2,..., "field-n": value-1-n},
  *  {"field-1": value-2-1, "field-2": value-2-2,..., "field-n": value-2-n}]</pre></code>
+ * <p>
+ * The type is immutable, meaning calls to setters like {@link #header(boolean)}
+ * do not modify the original reference, but return a new one instead.
  *
  * @author Lukas Eder
  */

jOOQ/src/main/java/org/jooq/TXTFormat.java

@@ -39,7 +39,11 @@ package org.jooq;
 
 
 /**
- * A CSV formatting type, which can be used to configure CSV imports / exports.
+ * A text formatting type, which can be used to configure text imports /
+ * exports.
+ * <p>
+ * The type is immutable, meaning calls to setters like {@link #maxRows(int)} do
+ * not modify the original reference, but return a new one instead.
  *
  * @author Lukas Eder
  */

jOOQ/src/main/java/org/jooq/XMLFormat.java

@@ -41,6 +41,9 @@ import static org.jooq.tools.StringUtils.rightPad;
 
 /**
  * An XML formatting type, which can be used to configure XML imports / exports.
+ * <p>
+ * The type is immutable, meaning calls to setters like {@link #header(boolean)}
+ * do not modify the original reference, but return a new one instead.
  *
  * @author Lukas Eder
  */