Added more documentation, changes the method signature for url to uri
conversion.