On 12/05/2013 08:13, Alan Bateman wrote:
....
A partial review, focusing mostly on the spec as we've been through a
few rounds on that part already. Overall I think the javadoc looks quite
good. I realize someone suggested using lowercase "url" in the javadoc
but as the usage is as an acronym then it might be clearer if it were in
uppercase, maybe "URL string" to avoid any confusion with java.net.URL.
This may be as a result of my comments. You are right, lowercase url is
not quite right.
I like "URL string", or
1) {code url}, since the given arg is named 'url'
2) "the given/specified {@code url}"
-Chris.
