emphasis name server more, fix formatting

SCCS-vsn: share/man/man5/hosts.5 6.3

diff --git a/usr/src/share/man/man5/hosts.5 b/usr/src/share/man/man5/hosts.5
index c7cd915..4716124 100644 (file)
--- a/usr/src/share/man/man5/hosts.5
+++ b/usr/src/share/man/man5/hosts.5
@@ -2,7 +2,7 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)hosts.5     6.2 (Berkeley) %G%
+.\"    @(#)hosts.5     6.3 (Berkeley) %G%

 .\"
 .TH HOSTS 5  ""
 .UC 5
 .\"
 .TH HOSTS 5  ""
 .UC 5


@@ -12,7 +12,7 @@ hosts \- host name data base
 The
 .I hosts
 file contains information regarding
 The
 .I hosts
 file contains information regarding

-the known hosts on the DARPA Internet.
+the known hosts on the network.

 For each host a single line should be present
 with the following information:
 .HP 10
 For each host a single line should be present
 with the following information:
 .HP 10


@@ -30,11 +30,24 @@ Items are separated by any number of blanks and/or
 tab characters.  A ``#'' indicates the beginning of
 a comment; characters up to the end of the line are
 not interpreted by routines which search the file.
 tab characters.  A ``#'' indicates the beginning of
 a comment; characters up to the end of the line are
 not interpreted by routines which search the file.

-This file is normally created from the official host
+.PP
+When using the name server
+.IR named (8),
+this file provides a backup when the name server
+is not running.
+For the name server, it is suggested that only a few addresses
+be included in this file.
+These include  address for the local interfaces that 
+.IR ifconfig (8C)
+needs at boot time and a few machines on the local network.
+.PP
+This file may be created from the official host

 data base maintained at the Network Information Control
 Center (NIC), though local changes may be required
 to bring it up to date regarding unofficial aliases
 data base maintained at the Network Information Control
 Center (NIC), though local changes may be required
 to bring it up to date regarding unofficial aliases

-and/or unknown hosts.
+and/or unknown hosts.  As the data base maintained at NIC
+is incomplete, use of the name server is recommend for
+sites on the DARPA Internet.

 .PP
 Network addresses are specified in the conventional
 ``.'' notation using the \fIinet_addr\fP() routine
 .PP
 Network addresses are specified in the conventional
 ``.'' notation using the \fIinet_addr\fP() routine


@@ -43,16 +56,9 @@ from the Internet address manipulation library,
 Host names may contain any printable
 character other than a field delimiter, newline,
 or comment character.
 Host names may contain any printable
 character other than a field delimiter, newline,
 or comment character.

-.PP
-When using the name server this file is used as a backup for when 
-.IR named (8)
-is not running.
-For the name server it is suggested that only a few addresses
-be included in this file.
-These include  address for the local interfaces that 
-.IR ifconfig (8C)
-needs at boot time and a few machines on the local network.

 .SH FILES
 /etc/hosts
 .SH "SEE ALSO"
 .SH FILES
 /etc/hosts
 .SH "SEE ALSO"

-gethostent(3N), ifconfig(8C), named(8), Name Server Operations Guide for BIND
+gethostbyname(3N), ifconfig(8C), named(8)
+.br
+Name Server Operations Guide for BIND