svn commit: r324515 - in stable: 10/lib/libc/net 11/lib/libc/net

[Cy Schubert]

Author: cy
Date: Wed Oct 11 05:07:37 2017
New Revision: 324515
URL: https://svnweb.freebsd.org/changeset/base/324515

Log:
  MFC r324249, 324260, and 324277
  
  Clarify the wording describing the stayopen flag and style fixes.

Modified:
  stable/11/lib/libc/net/gethostbyname.3
Directory Properties:
  stable/11/   (props changed)

Changes in other areas also in this revision:
Modified:
  stable/10/lib/libc/net/gethostbyname.3
Directory Properties:
  stable/10/   (props changed)

Modified: stable/11/lib/libc/net/gethostbyname.3
==============================================================================
--- stable/11/lib/libc/net/gethostbyname.3	Wed Oct 11 05:04:46 2017	(r324514)
+++ stable/11/lib/libc/net/gethostbyname.3	Wed Oct 11 05:07:37 2017	(r324515)
@@ -28,7 +28,7 @@
 .\"     From: @(#)gethostbyname.3	8.4 (Berkeley) 5/25/95
 .\" $FreeBSD$
 .\"
-.Dd May 12, 2006
+.Dd October 4, 2017
 .Dt GETHOSTBYNAME 3
 .Os
 .Sh NAME
@@ -189,19 +189,20 @@ function
 may be used to request the use of a connected
 .Tn TCP
 socket for queries.
+Queries will by default use
+.Tn UDP
+datagrams.
 If the
 .Fa stayopen
-flag is non-zero,
-this sets the option to send all queries to the name server using
+flag is non-zero, a
 .Tn TCP
-and to retain the connection after each call to
+connection to the name server will be used.
+It will remain open after calls to
 .Fn gethostbyname ,
 .Fn gethostbyname2
 or
-.Fn gethostbyaddr .
-Otherwise, queries are performed using
-.Tn UDP
-datagrams.
+.Fn gethostbyaddr
+have completed.
 .Pp
 The
 .Fn endhostent