Bug 35953

Summary: hosts.equiv(5) manual is confusing or wrong about host name
Product: Documentation Reporter: Gary W. Swearingen <swear>
Component: Books & ArticlesAssignee: Remko Lodder <remko>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Gary W. Swearingen 2002-03-16 04:50:01 UTC
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.
================

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.
How-To-Repeat: n/a
================
Comment 1 dfilter service freebsd_committer freebsd_triage 2007-12-08 22:43:23 UTC
remko       2007-12-08 22:43:17 UTC

  FreeBSD src repository

  Modified files:
    share/man/man5       hosts.equiv.5 
  Log:
  Improve readability for the hosts.equiv file regarding the notation
  of hostnames.
  
  PR:             docs/35953
  Submitted by:   "Gary W. Swearingen" <swear at blarg dot net>
                  With minor modifications by me.
  
  Revision  Changes    Path
  1.22      +3 -2      src/share/man/man5/hosts.equiv.5
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 2 Remko Lodder freebsd_committer freebsd_triage 2007-12-08 22:43:26 UTC
State Changed
From-To: open->patched

Patched in -CURRENT 
take ownership of the PR 


Comment 3 Remko Lodder freebsd_committer freebsd_triage 2007-12-08 22:43:26 UTC
Responsible Changed
From-To: freebsd-doc->remko

Patched in -CURRENT 
take ownership of the PR
Comment 4 dfilter service freebsd_committer freebsd_triage 2008-02-10 12:25:22 UTC
remko       2008-02-10 12:25:16 UTC

  FreeBSD src repository

  Modified files:        (Branch: RELENG_6)
    share/man/man5       hosts.equiv.5 
  Log:
  MFC rev 1.22 hosts.equiv.5
  
    Improve readability for the hosts.equiv file regarding the notation
    of hostnames.
  
    PR: docs/35953
    Submitted by: "Gary W. Swearingen" <swear at blarg dot net>
    With minor modifications by me.
  
  Revision  Changes    Path
  1.20.2.1  +3 -2      src/share/man/man5/hosts.equiv.5
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 5 dfilter service freebsd_committer freebsd_triage 2008-02-10 12:26:08 UTC
remko       2008-02-10 12:26:03 UTC

  FreeBSD src repository

  Modified files:        (Branch: RELENG_7)
    share/man/man5       hosts.equiv.5 
  Log:
  MFC rev 1.22 hosts.equiv.5
  
    Improve readability for the hosts.equiv file regarding the notation
    of hostnames.
  
    PR: docs/35953
    Submitted by: "Gary W. Swearingen" <swear at blarg dot net>
    With minor modifications by me.
  
  Revision  Changes    Path
  1.21.2.1  +3 -2      src/share/man/man5/hosts.equiv.5
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 6 Remko Lodder freebsd_committer freebsd_triage 2008-02-10 12:26:20 UTC
State Changed
From-To: patched->closed

MFC'ed to relevant branches, thanks for the submission!
Comment 7 dfilter service freebsd_committer freebsd_triage 2008-02-14 21:48:59 UTC
remko       2008-02-14 21:48:53 UTC

  FreeBSD src repository

  Modified files:        (Branch: RELENG_7_0)
    share/man/man5       hosts.equiv.5 
  Log:
  MFC rev 1.22 hosts.equiv.5
  
    v1.22
    Improve readability for the hosts.equiv file regarding the notation
    of hostnames.
  
    PR:           docs/35953
    Submitted by: "Gary W. Swearingen" <swear at blarg dot net>
                  With minor modifications by me.
  
  Approved by:    re (bmah)
  
  Revision  Changes    Path
  1.21.4.1  +3 -2      src/share/man/man5/hosts.equiv.5
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"