[src/trunk]: src/share/man/man7 Remove trailing whitespace; new sentence, new...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9f4e975bf25b
branches:  trunk
changeset: 757864:9f4e975bf25b
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Sep 29 14:34:07 2010 +0000

description:
Remove trailing whitespace; new sentence, new line; fix xref.

diffstat:

 share/man/man7/hostname.7 |  132 ++++++++++++++++++++++++---------------------
 1 files changed, 70 insertions(+), 62 deletions(-)

diffs (217 lines):

diff -r f7a6ab88dc69 -r 9f4e975bf25b share/man/man7/hostname.7
--- a/share/man/man7/hostname.7 Wed Sep 29 13:50:49 2010 +0000
+++ b/share/man/man7/hostname.7 Wed Sep 29 14:34:07 2010 +0000
@@ -1,3 +1,5 @@
+.\" $NetBSD: hostname.7,v 1.11 2010/09/29 14:34:07 wiz Exp $
+.\"
 .\" Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
@@ -31,17 +33,18 @@
 .\"
 .Dd February 16, 1994
 .Dt HOSTNAME 7
-.Os BSD 4
+.Os
 .Sh NAME
-.Nm hostname 
+.Nm hostname
 .Nd host name resolution description
 .Sh DESCRIPTION
-Hostnames are domains.  A domain is a hierarchical, dot-separated list
-of subdomains.  For example, the machine 
-.Dq Li monet , 
-in the 
+Hostnames are domains.
+A domain is a hierarchical, dot-separated list of subdomains.
+For example, the machine
+.Dq Li monet ,
+in the
 .Dq Li Berkeley
-subdomain of the 
+subdomain of the
 .Dq Li EDU
 subdomain of the Internet Domain Name System would be represented as
 .Pp
@@ -54,80 +57,85 @@
 (This task is usually performed by the library routine
 .Xr gethostbyname  3 . )
 The default method for resolving hostnames by the Internet name resolver is
-to follow RFC 1535's security recommendations.  Actions can be taken
-by the administrator to override these recommendations and to have the
-resolver behave the same as earlier, non-RFC 1535 
-resolvers.
+to follow RFC 1535's security recommendations.
+Actions can be taken by the administrator to override these
+recommendations and to have the resolver behave the same as earlier,
+non-RFC 1535 resolvers.
 .Pp
 The default method (using RFC 1535 guidelines) follows:
 .Pp
 If the name consists of a single component, i.e. contains no dot, and if the
-environment variable 
-.Dq Ev HOSTALIASES 
+environment variable
+.Dq Ev HOSTALIASES
 is set to the name of a file,
-that file is searched for a string matching the input hostname.  The file
+that file is searched for a string matching the input hostname.
+The file
 should consist of lines made up of two strings separated by white-space, the
 first of which is the hostname alias, and the second of which is the complete
-hostname to be substituted for that alias.  If a case-insensitive match is
+hostname to be substituted for that alias.
+If a case-insensitive match is
 found between the hostname to be resolved and the first field of a line in
 the file, the substituted name is looked up with no further processing.
 .Pp
-If there is at least one dot in the name, then the name is first tried 
-.Dq as-is .  
+If there is at least one dot in the name, then the name is first tried
+.Dq as-is .
 The number of dots to cause this action is configurable by setting the
-threshold using the 
+threshold using the
 .Dq Li ndots
-option in 
+option in
 .Pa /etc/resolv.conf
-(default:  1).  If the name ends with a dot, the trailing dot is
+(default: 1).
+If the name ends with a dot, the trailing dot is
 removed, and the remaining name is looked up (regardless of the setting of
-the 
-.Li ndots 
-option), without further processing. 
+the
+.Li ndots
+option), without further processing.
 .Pp
 If the input name does not end with a trailing dot, it is looked up by
-searching through a list of domains until a match is found.  If neither the
-search option in the
+searching through a list of domains until a match is found.
+If neither the search option in the
 .Pa /etc/resolv.conf
-file or the 
-.Dq Ev LOCALDOMAIN 
+file or the
+.Dq Ev LOCALDOMAIN
 environment variable is used, then the
-search list of domains contains only the full domain specified by the 
+search list of domains contains only the full domain specified by the
 .Li domain
 option (in
 .Pa /etc/resolv.conf )
-or the domain used in the local hostname.  For example, if the 
-.Dq Li domain 
-option is set to 
+or the domain used in the local hostname.
+For example, if the
+.Dq Li domain
+option is set to
 .Li CS.Berkeley.EDU ,
-then only 
-.Li CS.Berkeley.EDU 
+then only
+.Li CS.Berkeley.EDU
 will be in the search list, and this will be the only
-domain appended to the partial hostname.  For example, if 
-.Dq Li lithium 
+domain appended to the partial hostname.
+For example, if
+.Dq Li lithium
 is the name to be resolved, this would make
-.Li lithium.CS.Berkeley.EDU 
+.Li lithium.CS.Berkeley.EDU
 the only name to be tried using the search list.
 .Pp
-If the 
-.Li search 
+If the
+.Li search
 option is used in
 .Pa /etc/resolv.conf
-or the environment variable 
-.Dq Ev LOCALDOMAIN 
+or the environment variable
+.Dq Ev LOCALDOMAIN
 is set by the user, then
-the search list will include what is set by these methods.  For
-example, if the 
-.Dq Li search 
+the search list will include what is set by these methods.
+For example, if the
+.Dq Li search
 option contained
 .Pp
 .Dl CS.Berkeley.EDU CChem.Berkeley.EDU Berkeley.EDU
 .Pp
-then the partial hostname (e.g., 
-.Dq Li lithium ) 
-will be tried with 
+then the partial hostname (e.g.,
+.Dq Li lithium )
+will be tried with
 .Em each
-domain name appended (in the same order specified); the resulting hostnames 
+domain name appended (in the same order specified); the resulting hostnames
 that would be tried are:
 .Bd -literal -offset indent
 lithium.CS.Berkeley.EDU
@@ -135,30 +143,30 @@
 lithium.Berkeley.EDU
 .Ed
 .Pp
-The environment variable 
-.Dq Ev LOCALDOMAIN 
+The environment variable
+.Dq Ev LOCALDOMAIN
 overrides the
-.Dq Li search 
-and 
-.Dq Li domain 
-options, and if both 
-.Li search 
-and 
+.Dq Li search
+and
+.Dq Li domain
+options, and if both
+.Li search
+and
 .Li domain
-options are present in the resolver configuration file, then only the 
+options are present in the resolver configuration file, then only the
 .Em last
 one listed is used (see
 .Xr resolver 5 ) .
 .Pp
-If the name was not previously tried 
-.Dq as-is 
+If the name was not previously tried
+.Dq as-is
 (i.e., it fell below the
-.Dq Li ndots 
+.Dq Li ndots
 threshold or did not contain a dot), then the name as
 originally provided is attempted.
 .Sh ENVIRONMENT
 .Bl -tag -width "/etc/resolv.conf  "
-.It Ev LOCALDOMAIN   
+.It Ev LOCALDOMAIN
 Affects domains appended to partial hostnames.
 .It Ev HOSTALIASES
 Name of file containing
@@ -169,9 +177,9 @@
 .Bl -tag -width "/etc/resolv.conf  " -compact
 .It Pa /etc/resolv.conf
 See
-.Xr resolve 5 .
+.Xr resolver 5 .
 .El
 .Sh SEE ALSO
 .Xr gethostbyname 3 ,
 .Xr resolver 5 ,
-.Xr mailaddr 7 ,
+.Xr mailaddr 7