From bd952ac61e2c8e57de0ae6db134ffe185db2ba3b Mon Sep 17 00:00:00 2001
From: Ryan <ry@tinyclouds.org>
Date: Sat, 27 Jun 2009 19:06:29 +0200
Subject: [PATCH] Add some notes about extent of HTTP API

---
 website/api.html | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/website/api.html b/website/api.html
index f22c3aeccb..4b059e4e0a 100644
--- a/website/api.html
+++ b/website/api.html
@@ -614,6 +614,14 @@ server.listen(7000, "localhost");</pre>
     only be done with multiple <code>Cookie</code> lines.
   </i></p>
 
+  <p>
+    Node's HTTP abstraction deals with connection handling and message
+    parsing only. It parses the message into headers and body - but it does
+    not parse any of the headers or the body. This is left to the user. That
+    means, for example, that Node does not (and will never) provide API
+    to access or manipulate Cookies or multi-part bodies. 
+  </p>
+
   <h3 id="http_server"><code>node.http.Server</code></h3>
 
   <dl>
@@ -788,6 +796,11 @@ res.sendHeader(200, [ ["Content-Length", body.length]
         specifies how to encode it into a byte stream. By default the
         <code>encoding</code> is <code>"ascii"</code>.
       </p>
+
+      <p>
+        Note: This is the raw HTTP body and has nothing to do with 
+        higher-level multi-part body encodings that may be used. 
+      </p>
     </dd>
 
     <dt><code>res.finish()</code></dt>