diff --git a/libwebsockets-api-doc.html b/libwebsockets-api-doc.html
index acda2b5..00d38e1 100644
--- a/libwebsockets-api-doc.html
+++ b/libwebsockets-api-doc.html
@@ -629,6 +629,14 @@
 <tt><b>in</b></tt> points to the URI path requested and
 <b>libwebsockets_serve_http_file</b> makes it very
 simple to send back a file to the client.
+Normally after sending the file you are done
+with the http connection, since the rest of the
+activity will come by websockets from the script
+that was delivered by http, so you will want to
+return 1; to close and free up the connection.
+That's important because it uses a slot in the
+total number of client connections allowed set
+by MAX_CLIENTS.
 </blockquote>
 <h3>LWS_CALLBACK_SERVER_WRITEABLE</h3>
 <blockquote>