From owner-freebsd-doc  Fri Mar 15 20:50: 8 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 2EBED37B417
	for <freebsd-doc@freebsd.org>; Fri, 15 Mar 2002 20:50:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g2G4o1a29561;
	Fri, 15 Mar 2002 20:50:01 -0800 (PST)
	(envelope-from gnats)
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id DFBB537B404
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 15 Mar 2002 20:46:53 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id 7F729BE42
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 15 Mar 2002 20:46:53 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id UAA17167
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 15 Mar 2002 20:46:53 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g2G4nbR67937;
	Fri, 15 Mar 2002 20:49:37 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <gty9gtazha.9gt@localhost.localdomain>
Date: 15 Mar 2002 20:49:37 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: docs/35953: hosts.equiv(5) manual is confusing or wrong about host name
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         35953
>Category:       docs
>Synopsis:       hosts.equiv(5) manual is confusing or wrong about host name
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 15 20:50:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

Except for the first two words, this paragraph of the hosts.equive(5) manual

    Host names are specified in the conventional ''.'' (dot) notation using
    the inet_addr(3) routine from the Internet address manipulation library,
    inet(3).  Host names may contain any printable character other than a
    field delimiter, newline, or comment character.

is the same as the paragraph of the hosts(5) manual which starts
"Network addresses".  That is confusing, or wrong.

As far as I have determined from looking at the referenced inet_addr(3)
manual and inet_addr.c, the first sentence of hosts.equiv(5)'s paragraph
is erroneous.
================
>How-To-Repeat:
n/a
================
>Fix:

Replace the first sentence with "Host names are specified in the
conventional Internet DNS dotted-domains notation."

Maybe it also accepts numeric IP addresses, but I saw no evidence of it.
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message