Standardise on recordSeparator; fix incorrect Javadoc comments

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/csv/trunk@1468825 13f79535-47bb-0310-9956-ffa450edef68

Author: sebbASF

src/main/java/org/apache/commons/csv/CSVFormat.java

@@ -98,15 +98,15 @@ public static class CSVFormatBuilder {
          * @param nullToString TODO
          * @param header
          *            the header
-         * @param lineSeparator
-         *            the line separator to use for output
+         * @param recordSeparator
+         *            the record separator to use for output
          * @throws IllegalArgumentException if the delimiter is a line break character
          */
         // package protected for use by test code
         CSVFormatBuilder(final char delimiter, final Character quoteChar,
                 final Quote quotePolicy, final Character commentStart,
                 final Character escape, final boolean ignoreSurroundingSpaces,
-                final boolean ignoreEmptyLines, final String lineSeparator,
+                final boolean ignoreEmptyLines, final String recordSeparator,
                 String nullToString, final String[] header) {
             if (isLineBreak(delimiter)) {
                 throw new IllegalArgumentException("The delimiter cannot be a line break");
@@ -118,7 +118,7 @@ public static class CSVFormatBuilder {
             this.escape = escape;
             this.ignoreSurroundingSpaces = ignoreSurroundingSpaces;
             this.ignoreEmptyLines = ignoreEmptyLines;
-            this.recordSeparator = lineSeparator;
+            this.recordSeparator = recordSeparator;
             this.nullToString = nullToString;
             this.header = header;
         }
@@ -431,7 +431,7 @@ static boolean isLineBreak(final Character c) {
      * <li>withDelimiter(',')</li>
      * <li>withQuoteChar('"')</li>
      * <li>withEmptyLinesIgnored(true)</li>
-     * <li>withLineSeparator(CRLF)</li>
+     * <li>withRecordSeparator(CRLF)</li>
      * </ul>
      *
      * Shortcut for {@code CSVFormat.newBuilder(CSVFormat.DEFAULT)}
@@ -462,7 +462,7 @@ public static CSVFormatBuilder newBuilder() {
      * <ul>
      * <li>withDelimiter(',')</li>
      * <li>withQuoteChar('"')</li>
-     * <li>withLineSeparator(CRLF)</li>
+     * <li>withRecordSeparator(CRLF)</li>
      * </ul>
      */
     public static final CSVFormat RFC4180 =
@@ -476,7 +476,7 @@ public static CSVFormatBuilder newBuilder() {
      * <ul>
      * <li>withDelimiter(',')</li>
      * <li>withQuoteChar('"')</li>
-     * <li>withLineSeparator(CRLF)</li>
+     * <li>withRecordSeparator(CRLF)</li>
      * </ul>
      * <h3>Additional:</h3>
      * <ul>
@@ -500,7 +500,7 @@ public static CSVFormatBuilder newBuilder() {
      * <ul>
      * <li>withDelimiter(',')</li>
      * <li>withQuoteChar('"')</li>
-     * <li>withLineSeparator(CRLF)</li>
+     * <li>withRecordSeparator(CRLF)</li>
      * </ul>
      * Note: this is currently the same as RFC4180
      */