X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=http.md;h=a2d427b816702d57235aa9133b08d4ad24970373;hb=f60062deb36b708d1b28b0e264957562b06964f3;hp=e06a5bc6d952e0cc51200b853f60b3dc69e2ed74;hpb=ff5748653c7dc73c8dc80725dce38bb3119ddac3;p=mdref%2Fmdref

diff --git a/http.md b/http.md
index e06a5bc..a2d427b 100644
--- a/http.md
+++ b/http.md
@@ -1,6 +1,23 @@
 # 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.
+
+## Installation:
+
+This extension is hosted at PECL (<http://pecl.php.net>) and can be installed eith PEAR's pecl command:
+
+    # pecl install pecl_http
 
 ## INI Directives: