doc: clarify dns.lookup vs dns.resolve

Clarify and emphasize the differences between dns.lookup and the rest of
the functions in the dns module.
Would it be possible to link to a manpage for `getaddrinfo(3)` on the first reference to the syscall?