Adjustments to #2610.

2 files changed, 15 insertions, 5 deletions

diff --git a/lib/pure/asyncnet.nim b/lib/pure/asyncnet.nim
index 4b221eb72..712bba33b 100644
--- a/lib/pure/asyncnet.nim
+++ b/lib/pure/asyncnet.nim
@@ -472,7 +472,16 @@ when defined(ssl):
     socket.bioOut = bioNew(bio_s_mem())
     sslSetBio(socket.sslHandle, socket.bioIn, socket.bioOut)
 
-  proc wrapSocket*(ctx: SslContext, socket: AsyncSocket, handshake: SslHandshakeType) =
+  proc wrapConnectedSocket*(ctx: SslContext, socket: AsyncSocket,
+                            handshake: SslHandshakeType) =
+    ## Wraps a connected socket in an SSL context. This function effectively
+    ## turns ``socket`` into an SSL socket.
+    ##
+    ## This should be called on a connected socket, and will perform
+    ## an SSL handshake immediately.
+    ##
+    ## **Disclaimer**: This code is not well tested, may be very unsafe and
+    ## prone to security vulnerabilities.
     wrapSocket(ctx, socket)
 
     case handshake
diff --git a/lib/pure/net.nim b/lib/pure/net.nim
index 7dcc35495..29e115da1 100644
--- a/lib/pure/net.nim
+++ b/lib/pure/net.nim
@@ -102,7 +102,7 @@ type
 proc isIpAddress*(address_str: string): bool {.tags: [].}
 proc parseIpAddress*(address_str: string): IpAddress
 proc socketError*(socket: Socket, err: int = -1, async = false,
-lastError = (-1).OSErrorCode): void
+                  lastError = (-1).OSErrorCode): void
 
 proc isDisconnectionError*(flags: set[SocketFlag],
     lastError: OSErrorCode): bool =
@@ -259,9 +259,10 @@ when defined(ssl):
     if SSLSetFd(socket.sslHandle, socket.fd) != 1:
       raiseSSLError()
 
-  proc wrapSocket*(ctx: SSLContext, socket: Socket, handshake: SslHandshakeType) =
-    ## Wraps a socket in an SSL context. This function effectively turns
-    ## ``socket`` into an SSL socket.
+  proc wrapConnectedSocket*(ctx: SSLContext, socket: Socket,
+                            handshake: SslHandshakeType) =
+    ## Wraps a connected socket in an SSL context. This function effectively
+    ## turns ``socket`` into an SSL socket.
     ##
     ## This should be called on a connected socket, and will perform
     ## an SSL handshake immediately.