[Emacs-diffs] Changes to emacs/lispref/processes.texi

[Kim F. Storm]

Index: emacs/lispref/processes.texi
diff -u emacs/lispref/processes.texi:1.70 emacs/lispref/processes.texi:1.71
--- emacs/lispref/processes.texi:1.70   Sun Nov 20 15:15:57 2005
+++ emacs/lispref/processes.texi        Wed Jan  4 00:20:08 2006
@@ -1782,8 +1782,10 @@
 
 @item :family @var{family}
 @var{family} specifies the address (and protocol) family for
-communication.  @code{nil} stands for IPv4.  @code{local} specifies a
-Unix socket, in which case @var{host} is ignored.
+communication.  @code{nil} stands for automatically determine a the
+proper address family for the given @var{host} and @var{service}.
address@hidden specifies a Unix socket, in which case @var{host} is ignored.
address@hidden and @code{ipv6} specify to use IPv4 and IPv6 respectively.
 
 @item :local @var{local-address}
 For a server process, @var{local-address} is the address to listen on.
@@ -1803,9 +1805,18 @@
 
 @itemize -
 @item
-An IPv4 address is represented as a vector of integers @address@hidden
address@hidden @var{c} @var{d} @var{p}]} corresponding to numeric IP address
address@hidden@address@hidden@var{d} and port number @var{p}.
+An IPv4 address is represented as a five-element vector of four 8-bit
+integers and one 16-bit integer
address@hidden@var{a} @var{b} @var{c} @var{d} @var{p}]} corresponding to
+numeric IPv4 address @address@hidden@address@hidden and port number
address@hidden
+
address@hidden
+An IPv6 address is represented as a nine-element vector of 16-bit
+integers @address@hidden @var{b} @var{c} @var{d} @var{e} @var{f}
address@hidden @var{h} @var{p}]} corresponding to numeric IPv6 address
address@hidden:@var{b}:@var{c}:@var{d}:@var{e}:@var{f}:@var{g}:@var{h} and
+port number @var{p}.
 
 @item
 A local address is represented as a string which specifies the address
@@ -1979,6 +1990,8 @@
 address@hidden if datagrams are supported.
 @item (:family local)
 address@hidden if local (aka ``UNIX domain'') sockets are supported.
address@hidden (:family ipv6)
address@hidden if IPv6 is supported.
 @item (:service t)
 address@hidden if the system can select the port for a server.
 @end table
@@ -2041,14 +2054,19 @@
 
 @defun format-network-address address &optional omit-port
 This function converts the Lisp representation of a network address to
-a string.  For example, a five-element vector @address@hidden @var{b}
address@hidden @var{d} @var{p}]} represents an IP address
+a string.
+  A five-element vector @address@hidden @var{b}
address@hidden @var{d} @var{p}]} represents an IPv4 address
 @address@hidden@address@hidden and port number @var{p}.
 @code{format-network-address} converts that to the string
 @code{"@address@hidden@address@hidden:@var{p}"}.
+  A nine-element vector @address@hidden @var{b} @var{c} @var{d} @var{e}
address@hidden @var{g} @var{h} @var{p}]} represents an IPv6 address and port
+number.  @code{format-network-address} converts that to the string
address@hidden"address@hidden:@var{b}:@var{c}:@var{d}:@var{e}:@var{f}:@var{g}:@var{h}]:@var{p}"}.
 
 If @var{omit-port} is address@hidden, the value does not include
-the port number.
+the port number, or the port number is ignored if it does.
 @end defun
 
 @node Byte Packing