This wording doesn't make any sense to me. When we use the term deprecate, we are talking about interfaces. But gethostbyname isn't actually deprecated. getaddrinfo is an alternative interface rather than gethostbyname. But gethostbyname isn't deprecated.
I don't understand what the addition mean. At most I think it can be said the option is ineffective? > 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 14:38:39 -0000 > @@ -183,6 +183,9 @@ feature. > With this option > .Xr gethostbyname 3 > will return IPv6 addresses if available. > +This option is deprecated in favor of the > +.Xr getaddrinfo 3 > +interface. > 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. > > > -- > jca | PGP : 0x1524E7EE / 5135 92C1 AD36 5293 2BDF DDCC 0DFA 74AE 1524 E7EE