From 88a1140f46b47e8a3526a7239f343ca344e9a3e1 Mon Sep 17 00:00:00 2001
From: Micael Karlberg <bmk@erlang.org>
Date: Mon, 6 May 2019 10:44:07 +0200
Subject: [esock|doc] Make select_ref opaque

OTP-15731
---
 erts/doc/src/socket.xml | 20 ++++++--------------
 1 file changed, 6 insertions(+), 14 deletions(-)

(limited to 'erts/doc')

diff --git a/erts/doc/src/socket.xml b/erts/doc/src/socket.xml
index 48e91e93a7..47e84090ee 100644
--- a/erts/doc/src/socket.xml
+++ b/erts/doc/src/socket.xml
@@ -51,15 +51,10 @@
       <seealso marker="#type-select_info"><c>SelectInfo</c></seealso><c>}</c>.
       When data eventually arrives a 'select' message
       will be sent to the caller: </p>
-      <!--
-      <list type="ordered">
-	<item><c>{'$socket', Sock, select, Info}</c></item>
-      </list>
-      -->
       <taglist>
 	<!-- NOTE THAT THE EMPTY TAG IS INTENTIONAL -->
 	<tag></tag>
-	<item><c>{'$socket', Sock, select, Info}</c></item>
+	<item><c>{'$socket', socket(), select, select_ref()}</c></item>
       </taglist>
       <p>The caller can now make another
       call to the recv function and now expect data.</p>
@@ -67,20 +62,15 @@
       'current user' has called the function (recv in this case).</p>
       <p>Another message the user must be prepared for (when making asynchronous
       calls) is the <c>abort</c> message:</p>
-      <!--
-      <list type="ordered">
-	<item><c>{'$socket', Sock, abort, Info}</c></item>
-      </list>
-      -->
       <taglist>
 	<!-- NOTE THAT THE EMPTY TAG IS INTENTIONAL -->
 	<tag></tag>
-	<item><c>{'$socket', Sock, abort, Info}</c></item>
+	<item><c>{'$socket', socket(), abort, Info}</c></item>
       </taglist>
       <p>This message indicates
       that the (asynchronous) operation has been aborted.
-      If, for instance, the socket has been
-      closed (by another process), <c>Info</c> will be <c>{Ref, closed}</c>. </p>
+      If, for instance, the socket has been closed (by another process),
+      <c>Info</c> will be <c>{select_ref(), closed}</c>. </p>
     </note>
     <note>
       <p>There is currently <em>no</em> support for Windows. </p>
@@ -111,6 +101,8 @@
     </datatype>
     <datatype>
       <name name="select_ref"/>
+      <desc><p>A reference that uniquely identifies the (select) operation.</p>
+      </desc>
     </datatype>
     <datatype>
       <name name="select_info"/>
-- 
cgit v1.2.3