From: Robert Pluim <rpluim@gmail.com>
Date: Tue, 24 Sep 2019 11:52:48 +0000 (+0200)
Subject: Document how to listen on all interfaces in the Elisp manual
X-Git-Tag: emacs-27.0.90~1447
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9dcdb1384df51a568af5ec35c9f0a762d3cf205b;p=emacs.git

Document how to listen on all interfaces in the Elisp manual

* doc/lispref/processes.texi (Network Processes): Explain how to
listen on all interfaces.
---

diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 2ba5b1c893a..287221a184d 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -2685,7 +2685,11 @@ the local host.  If you specify @var{host} for a server, it must
 specify a valid address for the local host, and only clients
 connecting to that address will be accepted.  When using @code{local},
 by default IPv4 will be used, specify a @var{family} of @code{ipv6} to
-override this.
+override this.  To listen on all interfaces, specify an address of
+@samp{"0.0.0.0"} for IPv4 or @samp{"::"} for IPv6.  Note that on some
+operating systems, listening on @samp{"::"} will also listen on IPv4,
+so attempting to then listen separately on IPv4 will result in
+@code{EADDRINUSE} errors (@samp{"Address already in use"}).
 
 @item :service @var{service}
 @var{service} specifies a port number to connect to; or, for a server,