[ https://issues.apache.org/jira/browse/HADOOP-13679?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Daniel Barclay updated HADOOP-13679: ------------------------------------ Description: The documentation comment on {{org.apache.hadoop.fs.Path.Path(String)}} says: bq. Path strings are URIs, but with unescaped elements and some additional normalization. However, neither that comment nor {{org.apache.hadoop.fs.Path}}'s documentation comment says anything further about exactly what the differences between URI and {{org.apache.hadoop.fs.Path}} strings are. (Knowing what {{Path}} strings are supposed to be is important for determining whether the code is buggy or not. In particular, it seems that {{Path(String)}} and friends _might_ parse the scheme portion incorrectly (taking anything before a (first) colon rather than following the RFC 3986 syntax of: bq. {{scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )}} ).) So what exactly are the actual differences between {{Path}} string syntax and URI syntax? (I might be able to submit a PR with documentation changes, but I need the raw information first.) was: The documentation comment on {{org.apache.hadoop.fs.Path.Path(String)}} says: bq. Path strings are URIs, but with unescaped elements and some additional normalization. However, neither that comment nor {{org.apache.hadoop.fs.Path}}'s documentation comment says anything further about exactly what the differences between URI and {{org.apache.hadoop.fs.Path}} strings are. (Knowing what {{Path}} strings are supposed to be is important for determining whether the code is buggy or not. In particular, {{Path(String)}} and friends seem to parse the scheme portion incorrectly (taking anything before a (first) colon rather than following the RFC 3986 syntax of: bq. {{scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )}} ).) So what exactly are the actual differences between {{Path}} string syntax and URI syntax? (I might be able to submit a PR with documentation changes, but I need the raw information first.) > org.apache.hadoop.fs.Path doesn't specify mentioned differences from URIs > ------------------------------------------------------------------------- > > Key: HADOOP-13679 > URL: https://issues.apache.org/jira/browse/HADOOP-13679 > Project: Hadoop Common > Issue Type: Bug > Components: documentation > Reporter: Daniel Barclay > > The documentation comment on {{org.apache.hadoop.fs.Path.Path(String)}} says: > bq. Path strings are URIs, but with unescaped elements and some additional > normalization. > However, neither that comment nor {{org.apache.hadoop.fs.Path}}'s > documentation comment says anything further about exactly what the > differences between URI and {{org.apache.hadoop.fs.Path}} strings are. > (Knowing what {{Path}} strings are supposed to be is important for > determining whether the code is buggy or not. > In particular, it seems that {{Path(String)}} and friends _might_ parse the > scheme portion incorrectly (taking anything before a (first) colon rather > than following the RFC 3986 syntax of: > bq. {{scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )}} > ).) > So what exactly are the actual differences between {{Path}} string syntax and > URI syntax? > (I might be able to submit a PR with documentation changes, but I need the > raw information first.) -- This message was sent by Atlassian JIRA (v6.3.4#6332) --------------------------------------------------------------------- To unsubscribe, e-mail: common-issues-unsubscr...@hadoop.apache.org For additional commands, e-mail: common-issues-h...@hadoop.apache.org