[CSV-133] incorrect / obsolete JavaDoc for CSVParser

• Type: Bug
• Status: Open
• Priority: Trivial
• Resolution: Unresolved
• Affects Version/s: 1.0, 1.1
• Component/s: Documentation
• Labels: documentation
• Assignee: Unassigned
• Reporter: Holger Stratmann
• Created: 11/Sep/14 20:47
• Updated: 14/Feb/20 03:07

Description

In CSV-131, you asked for more reports, so here we go

The JavaDoc for public static CSVParser parse(final File file, final Charset charset, final CSVFormat format) seems to be obsolete. It says

<p><strong>Note:</strong> This method internally creates a FileReader using {@link java.io.FileReader#FileReader(java.io.File)} which in turn relies on the default encoding of the JVM that is executing the code. If this is insufficient create a URL to the file and use {@link #parse(URL, Charset, CSVFormat)}</p>

... which is clearly no longer the case since the method now takes a charset as a parameter and creates a "FileInputStreamReader" with this charset.