doc: Documented htpipe.

[ashd.git] / doc / ashd.doc

diff --git a/doc/ashd.doc b/doc/ashd.doc
index 144abfe..16030a8 100644 (file)
--- a/doc/ashd.doc
+++ b/doc/ashd.doc
@@ -110,9 +110,10 @@ variable called `HTTP_VERSION`. It is passed in full; i.e. as
 The response socket, as mentioned above, is also used for reading the
 request-body if the client provides one. For such purposes,
 *htparser*(1) ensures that the reader sees end-of-file at the end of
-the request-body, so that the reader (unlike in, for example, CGI)
-does not have to worry about the Content-Length header and counting
-bytes when reading.
+the request-body, allowing the reader (unlike in, for example, CGI) to
+not have to worry about the Content-Length header and counting bytes
+when reading, and also to handle chunked request-bodies in a natural
+fashion.
 
 To respond, the handler program needs to write an ordinary HTTP
 response to the response socket. That is, one line containing the HTTP
@@ -123,7 +124,8 @@ document of detailing the exact format of such a response, but the
 following points are noteworthy:
 
  * The HTTP version is actually ignored; it must simply be there for
-   completeness.
+   completeness. For the sake of forward compatibility, however,
+   handlers should output "HTTP/1.1".
 
  * In the header, Unix line endings are accepted; *htparser*(1) will
    still use CRLF line endings when passing the response to the