[src/trunk]: src/lib/libc/inet - Further clarify differences between inet_pto...

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

details:   https://anonhg.NetBSD.org/src/rev/d3253b720718
branches:  trunk
changeset: 780456:d3253b720718
user:      ginsbach <ginsbach%NetBSD.org@localhost>
date:      Wed Jul 25 14:51:15 2012 +0000

description:
- Further clarify differences between inet_pton() and inet_aton()
  (i.e. the former only accepts decimal numbers; no octal or hex)
- Clarify that inet_network() does not do byte rearrangement for one,
  two, and three part dotted addresses ala inet_aton() and inet_addr().
- whitespace

diffstat:

 lib/libc/inet/inet.3 |  12 +++++++++---
 1 files changed, 9 insertions(+), 3 deletions(-)

diffs (38 lines):

diff -r d0670d0cddaf -r d3253b720718 lib/libc/inet/inet.3
--- a/lib/libc/inet/inet.3      Wed Jul 25 07:26:17 2012 +0000
+++ b/lib/libc/inet/inet.3      Wed Jul 25 14:51:15 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet.3,v 1.4 2012/07/20 19:18:08 ginsbach Exp $
+.\"    $NetBSD: inet.3,v 1.5 2012/07/25 14:51:15 ginsbach Exp $
 .\"
 .\" Copyright (c) 1983, 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)inet.3     8.1 (Berkeley) 6/4/93
 .\"
-.Dd July 20, 2012
+.Dd July 25, 2012
 .Dt INET 3
 .Os
 .Sh NAME
@@ -338,8 +338,9 @@
 .St -p1003.1-2001 .
 Note that
 .Fn inet_pton
-does not accept 1-, 2-, or 3-part  dotted addresses; all four parts
+does not accept 1-, 2-, or 3-part dotted addresses; all four parts
 must be specified.
+Additionally all four parts of a dotted address must be decimal.
 This is a narrower input set than that accepted by
 .Fn inet_aton .
 .Sh HISTORY
@@ -393,3 +394,8 @@
 .Fn inet_addr
 should return a
 .Vt struct in_addr .
+.Pp
+The function
+.Fn inet_network
+does not support byte rearrangement for one, two, and three
+part addresses.