I'd remove this javadoc, as the code is pretty explanatory and HttpURLConnectionImpl isn't intended to be used directly.