Merge pull request apache#598 from makarandhinge/CSV-268-withFirstRecordAsHeader-javadoc-clean

[Javadoc] Clarify behavior of deprecated CSVFormat#withFirstRecordAsHeader()

Author: garydgregory

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

@@ -2788,6 +2788,9 @@ public CSVFormat withEscape(final Character escape) {
      *                           .get();
      * </pre>
      *
+     * <p>Any previously set headers are reset to empty.
+     * The resulting format will have {@code skipHeaderRecord = true}.</p>
+     *
      * @return A new CSVFormat that is equal to this but using the first record as header.
      * @see Builder#setSkipHeaderRecord(boolean)
      * @see Builder#setHeader(String...)