From 7fd93ff52ecefa6b25bc445eabba977f76bb3823 Mon Sep 17 00:00:00 2001
From: wollman <wollman@FreeBSD.org>
Date: Mon, 17 Jun 1996 20:01:05 +0000
Subject: Cross-reference addr2ascii(3) and inlcude a note about how those
 functions are preferred but are not widely available as yet.

---
 lib/libc/net/inet.3 | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

(limited to 'lib/libc/net')

diff --git a/lib/libc/net/inet.3 b/lib/libc/net/inet.3
index 9318f45..0aaee05 100644
--- a/lib/libc/net/inet.3
+++ b/lib/libc/net/inet.3
@@ -29,9 +29,10 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)inet.3	8.1 (Berkeley) 6/4/93
+.\"     From: @(#)inet.3	8.1 (Berkeley) 6/4/93
+.\"	$Id$
 .\"
-.Dd June 4, 1993
+.Dd June 17, 1996
 .Dt INET 3
 .Os BSD 4.2
 .Sh NAME
@@ -159,6 +160,18 @@ may be decimal, octal, or hexadecimal, as specified
 in the C language (i.e., a leading 0x or 0X implies
 hexadecimal; otherwise, a leading 0 implies octal;
 otherwise, the number is interpreted as decimal).
+.Pp
+The
+.Fn inet_aton
+and
+.Fn inet_ntoa
+functions are semi-deprecated in favor of the
+.Xr addr2ascii 3
+family.  However, since those functions are not yet widely implemented,
+portable programs cannot rely on their presence and will continue
+to use the
+.Xr inet 3
+functions for some time.
 .Sh DIAGNOSTICS
 The constant
 .Dv INADDR_NONE
@@ -168,6 +181,7 @@ and
 .Fn inet_network
 for malformed requests.
 .Sh SEE ALSO
+.Xr addr2ascii 3 ,
 .Xr gethostbyname 3 ,
 .Xr getnetent 3 ,
 .Xr hosts 5 ,
-- 
cgit v1.1