Elaborate on the difference between line number and record number

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

Author: britter

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

@@ -123,7 +123,13 @@ public String getComment() {
     /**
      * Returns the number of this record in the parsed CSV file.
      *
+     * <p>
+     * <strong>ATTENTION:</strong> If your CSV input has multi-line values, the returned number does not correspond to
+     * the current line number of the parser that created this record.
+     * </p>
+     *
      * @return the number of this record.
+     * @see CSVParser#getCurrentLineNumber() 
      */
     public long getRecordNumber() {
         return recordNumber;