Browse Source

Add a section about closing the connection in the guide

Loïc Hoguin 12 years ago
parent
commit
b2ba4d28f8
2 changed files with 16 additions and 0 deletions
  1. 15 0
      guide/req.md
  2. 1 0
      guide/toc.md

+ 15 - 0
guide/req.md

@@ -176,6 +176,21 @@ override all preset values. This means for example that you
 can set a default body and then override it when you decide
 to send a reply.
 
+Closing the connection
+----------------------
+
+HTTP/1.1 keep-alive allows clients to send more than one request
+on the same connection. This can be useful for speeding up the
+loading of webpages, but is not required. You can tell Cowboy
+explicitly that you want to close the connection by setting the
+`Connection` header to `close`.
+
+``` erlang
+{ok, Req2} = cowboy_req:reply(200,
+    [{<<"connection">>, <<"close">>}],
+    Req).
+```
+
 Reducing the memory footprint
 -----------------------------
 

+ 1 - 0
guide/toc.md

@@ -41,6 +41,7 @@ Cowboy User Guide
    *  Response
    *  Chunked response
    *  Response preconfiguration
+   *  Closing the connection
    *  Reducing the memory footprint
  *  [Hooks](hooks.md)
    *  On request