[src/trunk]: src clarify text for RES_USE_INET6. this is almost always unnec...

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

details:   https://anonhg.NetBSD.org/src/rev/27feca8a5bee
branches:  trunk
changeset: 480095:27feca8a5bee
user:      itojun <itojun%NetBSD.org@localhost>
date:      Mon Jan 03 11:56:05 2000 +0000

description:
clarify text for RES_USE_INET6.  this is almost always unnecessary.

diffstat:

 lib/libc/net/resolver.3      |  7 +++++--
 share/man/man5/resolv.conf.5 |  6 ++++--
 2 files changed, 9 insertions(+), 4 deletions(-)

diffs (43 lines):

diff -r 440f3abbe06d -r 27feca8a5bee lib/libc/net/resolver.3
--- a/lib/libc/net/resolver.3   Mon Jan 03 05:59:40 2000 +0000
+++ b/lib/libc/net/resolver.3   Mon Jan 03 11:56:05 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: resolver.3,v 1.11 1999/03/22 19:44:56 garbled Exp $
+.\"    $NetBSD: resolver.3,v 1.12 2000/01/03 11:56:05 itojun Exp $
 .\"
 .\" Copyright (c) 1985, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -168,7 +168,10 @@
 .Xr gethostbyname 3 .
 This option is enabled by default.
 .It Dv RES_USE_INET6
-Enable support for IPv6 addresses.
+Enables support for IPv6-only applications.
+This causes IPv4 addresses to be returned as an IPv4 mapped address.
+For example, 10.1.1.1 will be returned as ::ffff:10.1.1.1.
+The option is meaningful with certain kernel configuration only.
 .El
 .Pp
 The
diff -r 440f3abbe06d -r 27feca8a5bee share/man/man5/resolv.conf.5
--- a/share/man/man5/resolv.conf.5      Mon Jan 03 05:59:40 2000 +0000
+++ b/share/man/man5/resolv.conf.5      Mon Jan 03 11:56:05 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: resolv.conf.5,v 1.13 1999/12/28 02:40:38 mjl Exp $
+.\"    $NetBSD: resolv.conf.5,v 1.14 2000/01/03 11:56:06 itojun Exp $
 .\"
 .\" Copyright (c) 1986, 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -135,9 +135,11 @@
 (see
 .Xr resolver 3 ).
 .It Sy inet6
-enable support for IPv6 addresses, by setting RES_USE_INET6 in
+enable support for IPv6-only applications, by setting RES_USE_INET6 in
 _res.options (see
 .Xr resolver 3 ).
+The option is meaningful with certain kernel configuration only and
+use of this options is discourated.
 .It Sy ndots:n
 sets a threshold for the number of dots which
 must appear in a name given to res_query (see