docs

src/snake/http/BaseHTTPRequestHandler.hx

@@ -66,7 +66,7 @@ class BaseHTTPRequestHandler extends StreamRequestHandler {
 
 	/**
 		The version of the HTTP protocol we support.
-		set this to HTTP/1.1 to enable automatic keepalive
+		Set this to `"HTTP/1.1"` to enable automatic keepalive.
 	**/
 	public static var protocolVersion:String = "HTTP/1.0";
 

src/snake/socket/BaseServer.hx

@@ -66,6 +66,9 @@ class BaseServer {
 
 	/**
 		Stops the `serveForever()` loop.
+
+		Blocks until the loop has finished. This must be called while
+		`serveForever()` is running in another thread, or it will deadlock.
 	**/
 	public function shutdown():Void {
 		__shutdownRequest = true;

src/snake/socket/StreamRequestHandler.hx

@@ -7,7 +7,7 @@ import sys.net.Socket;
 import haxe.io.Input;
 
 /**
-	Define self.rfile and self.wfile for stream sockets.
+	Define `rfile` and `wfile` for stream sockets.
 **/
 class StreamRequestHandler extends BaseRequestHandler {
 	/**