javadoc currently uses Strings to represent relative paths, leading to a complications maintaining invariants regarding separators, and a number of abuses where intended invariants are not maintained, such as "paths" containing URI query strings.

It would be better to wrap such strings in a new abstraction that can enforce the appropriate invariants.