hadoop-common-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Barclay (JIRA)" <j...@apache.org>
Subject [jira] [Created] (HADOOP-13679) org.apache.hadoop.fs.Path doesn't specify mentioned differences from URIs
Date Tue, 04 Oct 2016 13:24:20 GMT
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-dev-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-dev-help@hadoop.apache.org


Mime
View raw message