diff --git a/src/main/java/org/apache/commons/csv/CSVFormat.java b/src/main/java/org/apache/commons/csv/CSVFormat.java index 402b0237e..442777a69 100644 --- a/src/main/java/org/apache/commons/csv/CSVFormat.java +++ b/src/main/java/org/apache/commons/csv/CSVFormat.java @@ -188,7 +188,22 @@ public final class CSVFormat implements Serializable { public static class Builder implements Supplier { /** - * Creates a new default builder. + * Creates a new default builder, as for {@link #RFC4180} but allowing empty lines. + * + *

+ * The {@link Builder} settings are: + *

+ * + * + * @see Predefined#Default + * @see DuplicateHeaderMode#ALLOW_ALL * * @return a copy of the builder */ @@ -196,18 +211,18 @@ public static Builder create() { // @formatter:off return new Builder() .setDelimiter(Constants.COMMA) - .setRecordSeparator(Constants.CRLF) .setQuote(Constants.DOUBLE_QUOTE_CHAR) + .setRecordSeparator(Constants.CRLF) .setIgnoreEmptyLines(true) .setDuplicateHeaderMode(DuplicateHeaderMode.ALLOW_ALL); // @formatter:on } /** - * Creates a new builder for the given format. + * Creates a new builder from the given format. * * @param csvFormat the source format. - * @return a copy of the builder + * @return a new builder. */ public static Builder create(final CSVFormat csvFormat) { return new Builder(csvFormat); @@ -981,6 +996,7 @@ public CSVFormat getFormat() { * * * @see Predefined#Default + * @see DuplicateHeaderMode#ALLOW_ALL */ public static final CSVFormat DEFAULT = new CSVFormat(Builder.create()); @@ -997,7 +1013,7 @@ public CSVFormat getFormat() { * * *

- * The {@link Builder} settings are: + * The {@link Builder} settings are the {@link #DEFAULT} with: *

*