add ProviderDirectory/DirectoryEntry javadoc [...]

change ProviderDirectory.addEntry header
throw exception in addEntry
deprecate ProviderDirectory.getEntries