[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] feature/async-dns c8bcb0b: Clarify levels of :nowait t.
From: |
Lars Ingebrigtsen |
Subject: |
[Emacs-diffs] feature/async-dns c8bcb0b: Clarify levels of :nowait t. |
Date: |
Sun, 21 Feb 2016 03:09:11 +0000 |
branch: feature/async-dns
commit c8bcb0bb1af86f2e55dc10e243ad8a0e4f69ed24
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>
Clarify levels of :nowait t.
* doc/lispref/processes.texi (Network Processes): Mention
levels of asynchronicity.
---
doc/lispref/processes.texi | 16 ++++++++++++----
1 files changed, 12 insertions(+), 4 deletions(-)
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 60b2d90..8234501 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -2409,14 +2409,22 @@ as it may depend on implementation defined constants,
data sizes, and
data structure alignment.
@end itemize
address@hidden :nowait @var{nowait}
-If @var{nowait} is address@hidden for a stream connection, return
address@hidden :nowait @var{bool}
+If @var{bool} is address@hidden for a stream connection, return
without waiting for the connection to complete. When the connection
succeeds or fails, Emacs will call the sentinel function, with a
second argument matching @code{"open"} (if successful) or
@code{"failed"}. The default is to block, so that
address@hidden does not return until the connection
-has succeeded or failed.
address@hidden does not return until the connection has
+succeeded or failed.
+
+If you're setting up an asynchronous TLS connection, you have to also
+provide the @code{:tls-parameters} parameter (see below).
+
+Depending on the capabilities of Emacs, how asynchronous
address@hidden:nowait} is may vary. The three elements that may (or may not)
+be done asynchronously are domain name resolution, socket setup, and
+(for TLS connections) TLS negotiation.
@item :tls-parameters
When opening a TLS connection, this should be where the first element
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] feature/async-dns c8bcb0b: Clarify levels of :nowait t.,
Lars Ingebrigtsen <=