Jeremie Courreges-Anglas <j...@wxcvbn.org> wrote: > New proposal after discussing this with Theo. > > > Index: net/res_init.3 > =================================================================== > RCS file: /cvs/src/lib/libc/net/res_init.3,v > retrieving revision 1.2 > diff -u -p -r1.2 res_init.3 > --- net/res_init.3 25 Apr 2020 14:30:05 -0000 1.2 > +++ net/res_init.3 25 Apr 2020 15:59:51 -0000 > @@ -183,6 +183,10 @@ feature. > With this option > .Xr gethostbyname 3 > will return IPv6 addresses if available. > +This option is deprecated, software should use the > +.Xr getaddrinfo 3 > +interface instead of modifying the behavior of > +.Xr gethostbyname 3 . > On some operating systems this option also causes IPv4 addresses to be > returned as IPv4-mapped IPv6 addresses. > For example, 10.1.1.1 will be returned as ::ffff:10.1.1.1.
I like this a lot better, because it is clear it is the OPTION which is deprecated, and subtly hints this option existed for a bad reason.