flush

[mdref/mdref-http] / http.md

diff --git a/http.md b/http.md
index e06a5bc6d952e0cc51200b853f60b3dc69e2ed74..bf651e2003b9de25efad5113eab990764002e2d1 100644 (file)
--- a/http.md
+++ b/http.md
@@ -1,6 +1,17 @@
 # pecl/http v2
 
-This documentation is work-in-progress.
+> **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: