Daniel Barclay created HADOOP-13679:
---------------------------------------
Summary: 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, {{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.)
--
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
