X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=http.md;h=bf651e2003b9de25efad5113eab990764002e2d1;hb=fb441d8cee5fbab5f4621ce0361a848045bfed43;hp=6175e26c14ad76f980ed602ba08a95527161d260;hpb=333f749f9ae65fecd6b52b06fde3dceda1579470;p=mdref%2Fmdref

diff --git a/http.md b/http.md
index 6175e26..bf651e2 100644
--- a/http.md
+++ b/http.md
@@ -1,5 +1,20 @@
-# namespace http
+# pecl/http v2
 
-This is pecl_http-v2.
+> **Note:** This documentation is work-in-progress.
+
+## About:
+
+Extended HTTP support. Again. Keep in mind that it's got the major version 2, because it's incompatible with pecl_http v1.
+
+* Introduces the http namespace.
+* Message bodies have been remodeled to use PHP temporary streams instead of in-memory buffers.
+* The utterly misunderstood HttpResponse class has been reimplemented as http\Env\Response inheriting http\Message.
+* Currently, there's only one Exception class left, http\Exception.
+* Errors triggered by the extension can be configured statically by http\Object::$defaultErrorHandling or inherited http\Object->errorHandling.
+* The request ecosystem has been modularized to support different libraries, though for the moment only libcurl is supported.
+
+## INI Directives:
+
+* http.etag.mode = "crc32b"  
+  Default hash method for dynamic response payloads to generate an ETag.
 
-This documentation is work-in-progress.