A DESCRIPTION OF THE REQUEST :
The FileReader(String) constructor documentation contains no information about how the String argument is interpreted if it is not a simple name.

JUSTIFICATION :
See this question on StackOverflow I answered:

http://stackoverflow.com/questions/25931856/file-not-found-exception-in-executing-javascript-in-nashorn

When writing the answer, I discovered that there was no way the person could have known from the documentation alone; it's a sort of unstated assumption how the String argument to FileReader is interpreted. Should be cleaned up.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
A pointer to the java.io.File documentation would probably be sufficient.
ACTUAL -
"Creates a new FileReader, given the name of the file to read from."

---------- BEGIN SOURCE ----------
Not applicable.
---------- END SOURCE ----------

CUSTOMER SUBMITTED WORKAROUND :
Know a lot about Java; don't be a beginner. :)