diff --git a/lib/libwebsockets.c b/lib/libwebsockets.c
index 1160d9bf..4876099b 100644
--- a/lib/libwebsockets.c
+++ b/lib/libwebsockets.c
@@ -674,9 +674,11 @@ libwebsocket_service_timeout_check(struct libwebsocket_context *context,
  * @pollfd:	The pollfd entry describing the socket fd and which events
  *		happened.
  *
- *	This function closes any active connections and then frees the
- *	context.  After calling this, any further use of the context is
- *	undefined.
+ *	This function takes a pollfd that has POLLIN or POLLOUT activity and
+ *	services it according to the state of the associated struct libwebsocket.
+ *
+ *	The one call deals with all "service" that might happen on a socket
+ *	including listen accepts, http files as well as websocket protocol.
  */
 
 int
diff --git a/libwebsockets-api-doc.html b/libwebsockets-api-doc.html
index d907e9b7..d910b2d7 100644
--- a/libwebsockets-api-doc.html
+++ b/libwebsockets-api-doc.html
@@ -55,9 +55,11 @@ happened.
 </dl>
 <h3>Description</h3>
 <blockquote>
-This function closes any active connections and then frees the
-context.  After calling this, any further use of the context is
-undefined.
+This function takes a pollfd that has POLLIN or POLLOUT activity and
+services it according to the state of the associated struct libwebsocket.
+<p>
+The one call deals with all "service" that might happen on a socket
+including listen accepts, http files as well as websocket protocol.
 </blockquote>
 <hr>
 <h2>libwebsocket_context_destroy - Destroy the websocket context</h2>