In order to document the free functions in twistd.names.client implement most of the interface of IResolver, so the documentation should match them. #4685 handles this by just having @see` annotations. It would be better if we could include the documentation automatically.

I wanted to remove the docstring for
twisted.names.client.getHostByName, but that version of the function
contains an "effort" argument which is not in
IResolverSimple.getHostByName. I've raised #6496 to suggest removing
the effort argument.