Clarify methods that accept a "URI".

[garretwilson]

I see things like Condition.get(String uri) which say that they accept a URI. But the examples show things like get("/demo"), which is not a URI at all --- it's a path. And there's no documentation about encoding at all.

Yes I know that Request.getRequestURI() really returns a path, but that's an old API and it was named badly to begin with. There are so many variations of things that are partial paths, full paths, encoded, raw, etc.; see https://stackoverflow.com/a/21046620/421049 for just a taste.

So it would really help if the API documentation to indicate:

• Whether the argument should be a URI or a path.
• If a path, whether it should be an absolute path or relative to some webapp.
• Whether the path should be URI-encoded or not.

[mkotsur]

Ok, very good point. Would you like to contribute to this via a PR?