procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Mention sentinels in conjunction with :nowait t.

Browse source 
* doc/lispref/processes.texi (Network Processes): Mention the
recommended way of using sentinels with :nowait t.
This commit is contained in:
Lars Ingebrigtsen 2016-02-22 13:20:04 +11:00
parent b55bf9f45a
commit 41895f93be
1 changed files with 8 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
doc/lispref/processes.texi
View file

@ -2426,6 +2426,14 @@ Depending on the capabilities of Emacs, how asynchronous
be done asynchronously are domain name resolution, socket setup, and
(for TLS connections) TLS negotiation.
Many functions that interact with process objects, (for instance,
@code{process-datagram-address}) rely on them at least having a socket
before they can return a useful value. These functions will block
until the socket has achieved the desired status. The recommended way
of interacting with asynchronous sockets is to place a sentinel on the
process, and not try to interact with it before it has changed status
to @samp{"run"}. That way, none of these functions will block.
@item :tls-parameters
When opening a TLS connection, this should be where the first element
is the TLS type (which should either be @code{gnutls-x509pki} or