[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] feature/async-dns 41895f9: Mention sentinels in conjunctio
From: |
Lars Ingebrigtsen |
Subject: |
[Emacs-diffs] feature/async-dns 41895f9: Mention sentinels in conjunction with :nowait t. |
Date: |
Mon, 22 Feb 2016 02:20:16 +0000 |
branch: feature/async-dns
commit 41895f93be76cc1489856debaa3578f849451984
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>
Mention sentinels in conjunction with :nowait t.
* doc/lispref/processes.texi (Network Processes): Mention the
recommended way of using sentinels with :nowait t.
---
doc/lispref/processes.texi | 8 ++++++++
1 files changed, 8 insertions(+), 0 deletions(-)
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 8234501..79cebaa 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -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,
address@hidden) 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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] feature/async-dns 41895f9: Mention sentinels in conjunction with :nowait t.,
Lars Ingebrigtsen <=