RFR 8215008: Clear confusion between URL/URI paths and file system paths

[Daniel Fuchs]

Thanks for the feedback Alan!

I have updated the webrev accordingly:

http://cr.openjdk.java.net/~dfuchs/webrev_8215008/webrev.01/

best regards,

-- daniel

On 07/12/2018 15:20, Alan Bateman wrote:
> I've come across dozens of cases where code has been trying to use a URL 
> path as a file path so an API note is a good idea. On the wording then 
> "there is not necessarily any direct relationship ..." is a bit 
> confusing to read, at least for file URIs where the file path is encoded 
> as a URI. I also think it would be useful to link to the APIs that do 
> the encoding/decoding, as in File(URI), File::toURI, Path.of(URI), 
> Path::toUri.
> On 07/12/2018 15:13, Daniel Fuchs wrote:
> Please find below a fix for
> 8215008: Clear confusion between URL/URI paths and file system paths
> https://bugs.openjdk.java.net/browse/JDK-8215008
> 
> It adds a small non normative @apiNote to java.net.URL and java.net.URI.