Fix grammar and errors

The example for the String[] API was wrong, it should pass only Strings, not a String and an Instant.

Author: garydgregory

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

@@ -521,30 +521,36 @@ public Builder setHeader(final String... header) {
         }
 
         /**
-         * Sets the header comments to the given values. The comments will be printed first, before the headers. This setting is ignored by the parser.
-         *
+         * Sets the header comments to the given values before the CSV data. 
          * <p>
-         * Use {@link Builder#setCommentMarker(char)} or {@link Builder#setCommentMarker(Character)} to set the comment marker to be used with each comment.
+         * This setting is ignored by the parser.
          * </p>
          * <p>
-         * If comment marker is not set (null) then none of header comments will get printed.
+         * Comments are printed first, before headers.
          * </p>
+         * <p>
+         * Use {@link Builder#setCommentMarker(char)} or {@link Builder#setCommentMarker(Character)} to set the comment marker written at the start of 
+         * each comment line.
          * </p>
-         * For an example, if you use comment marker and header comments as below
+         * <p>
+         * If the comment marker is not set, then the header comments are ignored.
+         * </p>
+         * <p>
+         * For example:
          * </p>
          * <pre>
-         * builder.setHeaderComments(&quot;Generated by Apache Commons CSV.&quot;, Instant.now());
-         * builder.setCommentMarker('#');
+         * builder.setCommentMarker('#')
+         *        .setHeaderComments("Generated by Apache Commons CSV", Instant.ofEpochMilli(0));
          * </pre>
-         *<p>
-         *you would get header lines printed something similar to below
-         *</p>
+         * <p>
+         * writes:
+         * </p>
          * <pre>
          * # Generated by Apache Commons CSV.
-         * # 2023-08-25T11:37:51.148073200Z
+         * # 1970-01-01T00:00:00Z
          * </pre>
          *
-         * @param headerComments the headerComments which will be printed by the Printer before the actual CSV data.
+         * @param headerComments the headerComments which will be printed by the Printer before the CSV data.
          * @return This instance.
          */
         public Builder setHeaderComments(final Object... headerComments) {
@@ -553,30 +559,36 @@ public Builder setHeaderComments(final Object... headerComments) {
         }
 
         /**
-         * Sets the header comments to the given values. The comments will be printed first, before the headers. This setting is ignored by the parser.
-         *
+         * Sets the header comments to the given values before the CSV data. 
          * <p>
-         * Use {@link Builder#setCommentMarker(char)} or {@link Builder#setCommentMarker(Character)} to set the comment marker to be used with each comment.
+         * This setting is ignored by the parser.
          * </p>
          * <p>
-         * If comment marker is not set (null) then none of header comments will get printed.
+         * Comments are printed first, before headers.
          * </p>
+         * <p>
+         * Use {@link Builder#setCommentMarker(char)} or {@link Builder#setCommentMarker(Character)} to set the comment marker written at the start of 
+         * each comment line.
          * </p>
-         * For an example, if you use comment marker and header comments as below
+         * <p>
+         * If the comment marker is not set, then the header comments are ignored.
+         * </p>
+         * <p>
+         * For example:
          * </p>
          * <pre>
-         * builder.setHeaderComments(&quot;Generated by Apache Commons CSV.&quot;, Instant.now());
-         * builder.setCommentMarker('#');
+         * builder.setCommentMarker('#')
+         *        .setHeaderComments("Generated by Apache Commons CSV", Instant.ofEpochMilli(0).toString());
          * </pre>
-         *<p>
-         *you would get header lines printed something similar to below
-         *</p>
+         * <p>
+         * writes:
+         * </p>
          * <pre>
          * # Generated by Apache Commons CSV.
-         * # 2023-08-25T11:37:51.148073200Z
+         * # 1970-01-01T00:00:00Z
          * </pre>
          *
-         * @param headerComments the headerComments which will be printed by the Printer before the actual CSV data.
+         * @param headerComments the headerComments which will be printed by the Printer before the CSV data.
          * @return This instance.
          */
         public Builder setHeaderComments(final String... headerComments) {