big update's coming
authorMichael Wallner <mike@php.net>
Wed, 20 Nov 2013 12:29:05 +0000 (13:29 +0100)
committerMichael Wallner <mike@php.net>
Wed, 20 Nov 2013 12:29:05 +0000 (13:29 +0100)
122 files changed:
http/Client/Request.md
http/Client/Request/__construct.md
http/Client/Request/addQuery.md
http/Client/Request/addSslOptions.md
http/Client/Request/setContentType.md
http/Client/Request/setOptions.md
http/Client/Request/setQuery.md
http/Client/Request/setSslOptions.md
http/Client/Response/getCookies.md
http/Client/Response/getTransferInfo.md
http/Client/__construct.md
http/Client/addCookies.md
http/Client/addSslOptions.md
http/Client/attach.md
http/Client/dequeue.md
http/Client/detach.md
http/Client/enableEvents.md
http/Client/enablePipelining.md
http/Client/enqueue.md
http/Client/getHistory.md
http/Client/getObservers.md
http/Client/getProgressInfo.md
http/Client/getResponse.md
http/Client/getTransferInfo.md
http/Client/notify.md
http/Client/requeue.md
http/Client/send.md
http/Client/setCookies.md
http/Client/setOptions.md
http/Client/setSslOptions.md
http/Cookie.md
http/Cookie/.md [deleted file]
http/Cookie/__construct.md
http/Cookie/addCookie.md
http/Cookie/addCookies.md
http/Cookie/addExtra.md
http/Cookie/addExtras.md
http/Cookie/setCookie.md
http/Cookie/setCookies.md
http/Cookie/setDomain.md
http/Cookie/setExpires.md
http/Cookie/setExtra.md
http/Cookie/setExtras.md
http/Cookie/setFlags.md
http/Cookie/setMaxAge.md
http/Cookie/setPath.md
http/Encoding/Stream.md
http/Encoding/Stream/Dechunk/decode.md
http/Encoding/Stream/Deflate/encode.md
http/Encoding/Stream/Inflate/decode.md
http/Encoding/Stream/__construct.md
http/Encoding/Stream/finish.md
http/Encoding/Stream/flush.md
http/Encoding/Stream/update.md
http/Env.md
http/Env/Request/__construct.md
http/Env/Response/__construct.md
http/Env/Response/setCacheControl.md
http/Env/Response/setContentDisposition.md
http/Env/Response/setContentEncoding.md
http/Env/Response/setContentType.md
http/Env/Response/setEnvRequest.md
http/Env/Response/setEtag.md
http/Env/Response/setLastModified.md
http/Env/getRequestBody.md
http/Exception.md
http/Exception/BadConversionException.md [new file with mode: 0644]
http/Exception/BadHeaderException.md [new file with mode: 0644]
http/Exception/BadMessageException.md [new file with mode: 0644]
http/Exception/BadMethodCallException.md [new file with mode: 0644]
http/Exception/BadQueryStringException.md [new file with mode: 0644]
http/Exception/BadUrlException.md [new file with mode: 0644]
http/Exception/InvalidArgumentException.md [new file with mode: 0644]
http/Exception/RuntimeException.md [new file with mode: 0644]
http/Exception/UnexpectedValueException.md [new file with mode: 0644]
http/Header.md
http/Header/parse.md
http/Header/unserialize.md
http/Message.md
http/Message/Body.md
http/Message/Body/__construct.md
http/Message/Body/addForm.md
http/Message/Body/addPart.md
http/Message/Body/append.md
http/Message/__construct.md
http/Message/detach.md
http/Message/getBody.md
http/Message/getHeader.md
http/Message/getParentMessage.md
http/Message/getRequestMethod.md
http/Message/getRequestUrl.md
http/Message/getResponseCode.md
http/Message/getResponseStatus.md
http/Message/prepend.md
http/Message/reverse.md
http/Message/setBody.md
http/Message/setHttpVersion.md
http/Message/setInfo.md
http/Message/setRequestMethod.md
http/Message/setRequestUrl.md
http/Message/setResponseCode.md
http/Message/setResponseStatus.md
http/Message/splitMultipartBody.md
http/Message/unserialize.md
http/Object.md [deleted file]
http/Object/getDefaultErrorHandling.md [deleted file]
http/Object/getErrorHandling.md [deleted file]
http/Object/setDefaultErrorHandling.md [deleted file]
http/Object/setErrorHandling.md [deleted file]
http/Object/triggerError.md [deleted file]
http/Params.md
http/Params/__construct.md
http/QueryString.md
http/QueryString/__construct.md
http/QueryString/getGlobalInstance.md
http/QueryString/getIterator.md
http/QueryString/mod.md
http/QueryString/xlate.md
http/Url.md
http/Url/__construct.md
http/Url/mod.md
index.js

index a3845502a623941d6d1ee61f23f25180623fc551..16019cecb5f6abfca235b39838765741f929ab96 100644 (file)
@@ -10,6 +10,6 @@ None.
 
 ## Properties:
 
-* array $options = NULL  
-  Options for this request, which override client options.
+* protected $options = NULL  
+  Array of options for this request, which override client options.
 
index e14a7ad91afcddcf95b606c1ed3c77b4967265b4..d576bf6b6f6caeb47e3ef90d050429b6e10b6dd4 100644 (file)
@@ -15,7 +15,8 @@ Create a new client request message to be enqueued and sent by http\Client.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
index 5ecd5abad401f980072708c9ce94171b008097b0..b34de24566c5c79a837ea6e2025efa6582323c43 100644 (file)
@@ -11,3 +11,8 @@ See http\Client\Request::setQuery() and http\Message::setRequestUrl().
 ## Returns:
 
 * http\Client\Request, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadQueryStringException
index 40b4bd3aab55a0f01d31e5ba92b772ead0b302f0..f11e35c208949d04377dee19d6204d91b6202b92 100644 (file)
@@ -11,3 +11,7 @@ See http\Client\Request::setSslOptions(), http\Client\Request::setOptions() and
 ## Returns:
 
 * http\Client\Request, self.
+
+## Throws:
+
+* http\Client\InvalidArgumentException
index 2ec6451040d88eaa6c66ec3eed7379a96dc2b03e..68636c7a95eda9c096be89c5c0e4151133d3ec07 100644 (file)
@@ -11,6 +11,7 @@ Set the MIME content type of the request message.
 
 * http\Client\Request, self.
 
-## Warnings:
+## Throws:
 
-* HTTP_E_INVALID_PARAM, if $content_type does not follow the general "primary/secondary" notation.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 4742d44fd0c3d585ca8318518ace686556163ccf..577095e9caf3b3a55a10982aa83857032c6e00b8 100644 (file)
@@ -14,3 +14,6 @@ See http\Client::setOptions() and http\Client\Curl.
 
 * http\Client\Request, self.
 
+## Throws:
+
+* http\Client\InvalidArgumentException
index 009acbda70f39077d381e831e917ff27fc9f1568..68deb3d91be985a911f3b8e62c8f1a11840925d4 100644 (file)
@@ -11,6 +11,11 @@ See http\Client\Request::addQuery() and http\Message::setRequestUrl().
 
 * http\Client\Request, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadQueryStringException
+
 ## Example:
 
     <?php
index dce1008babfd7e708fc286c9d8f4a94962b602dd..36bdcbc77abc62e2a106c47050008b8108f866b4 100644 (file)
@@ -11,3 +11,7 @@ See http\Client\Request::setOptions() and http\Client\Curl::$ssl options.
 ## Returns:
 
 * http\Client\Request, self.
+
+## Throws:
+
+* http\Client\InvalidArgumentException
index 15539b92f7b42f6cf86dc8c6803a235f9349fec4..7ac1fddddc29851f4f7ba8b2a73ce44229d10b8c 100644 (file)
@@ -14,7 +14,6 @@ Parses any "Set-Cookie" response headers into an http\Cookie list. See http\Cook
 
 * array, list of http\Cookie instances.
 
-
 ## Example:
 
     <?php
index 94eaf4356e401f1904102e73ac4171133e8f873b..94368ed4fdcf691a6c1cc9be7ae8f1c064f4e2bf 100644 (file)
@@ -10,6 +10,11 @@ See http\Client::getTransferInfo().
 
 ## Returns:
 
-* array, all transfer info if $name was not given.
+* object, stdClass instance with all transfer info if $name was not given.
 * mixed, the specific transfer info for $name.
-* false, if the request was not complete or $name was not found.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\UnexpectedValueException
index adc62998e76b7c49d78f8f2054bb352254671c3d..d50178acaf5cf19e20177659f38ad7d7075ab4c3 100644 (file)
@@ -14,4 +14,6 @@ Persisted resources identified by $persistent_handle_id will be re-used if avail
 
 # Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
+* http\Exception\RuntimeException
index 69b34db5fa9ca5413264a03c8ba13659778a2e30..dd4a17b926a146dd07ae322b026bd824c37b8a28 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::setCookies().
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index b31f2cf73c0c6b799f7337145964ef28fccad353..639ae6529fc07a8702e6ebbcdefa0069ffb7fe01 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::setSslOptions(), http\Client::setOptions() and http\Client\Curl
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exceptionc\InvalidArgumentException
index 8048a3ec329678313adb5229274c7582ca8361dd..3ea99fcc39ac9c6cde7120371bd88f69f5c9c0d8 100644 (file)
@@ -11,3 +11,8 @@ Attached observers will be notified with progress of each transfer.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 1b3fd2705684428e557f9ad6b4149fe42bbd5cad..a0d8ef71f9754db26afaf91120ed9a9489e10d0b 100644 (file)
@@ -15,4 +15,6 @@ See http\Client::requeue(), if you want to requeue the request, instead of calli
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\RuntimeException
index a4c70e6e01d0d781635aaa89a00fccc09022953a..d24490ffc2340e415f36e98a40c88f9e3d7db306 100644 (file)
@@ -10,3 +10,8 @@ Implements SplSubject. Detach $observer, which has been previously attached.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index de3889304fa2e53ee33587fb61eb40f1565d1a54..96bfd77e4bb2f4545644220ed1658ce9e65befdf 100644 (file)
@@ -11,3 +11,7 @@ Enable usage of an event library like libevent, which might improve performance
 
 * http\Client, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 6f1920696d8c32753eaaa12367b519ad15488a2f..1f4c225133f8ccadcd99af931a96f89767f28025 100644 (file)
@@ -10,3 +10,8 @@ Enable sending pipelined requests to the same host if the driver supports it.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 24ba8fa949158a9b792e2c63b2e224109c89d942..b5a6d756cee268fdc37a7ac82d910b90ec29abfb 100644 (file)
@@ -18,7 +18,9 @@ See http\Client::dequeue() and http\Client::send().
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\RuntimeException
 
 ## Example:
 
index 55beb658a6d5eb35ec8c8337a96f4221d60d4871..60d3ecff62d15b37a9ff120e55fc43ebe01c74b5 100644 (file)
@@ -12,6 +12,10 @@ None.
 
 * http\Message, the request/response message chain representing the client's history.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+
 ## Example:
 
     <?php
index fe7d0fb07ca5315c474e87b935eae75b3bce175e..a579f4a5f30253103ea1923de02b37105ccdaf31 100644 (file)
@@ -12,4 +12,5 @@ None.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index ca7a5e9810e0958e967a5aafb15cf34b6a7ba096..edcc394acc5b8a262c43dfc0afab230edc88f2af 100644 (file)
@@ -14,7 +14,8 @@ Retrieve the progress information for $request.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
index e2dc7ca2e6836dc4978613511e37814fe5679979..00d3d95e5b2d06d23056887aec88915b02d530b1 100644 (file)
@@ -12,7 +12,12 @@ Retrieve the corresponding reponse of an already finished request, or the last r
 ## Returns:
 
 * http\Client\Response, the stored response for the request, or the last that was received.
-* NULL, if no response was found.
+* NULL, if no more response was available to pop, when no $request was given.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
index 30d5cc90fbaf7ffec3321a95d1eeb44bb4003ea9..6b623990529cd86042a6caa65765a605f51bb696 100644 (file)
@@ -13,7 +13,8 @@ Get transfer related informatioin for a running or finished request.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
index d3f0b86efcaecf26770b4a1ed508e72170194c2b..517539fdf36e39f2040eb7efeae36556e967a919 100644 (file)
@@ -13,6 +13,11 @@ Implements SplSubject. Notify attached observers about progress with $request.
 
 * http\Client, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
+
 ## Example:
 
     <?php
index 1a3d6fe48d48cd0ccc923c57854feb1d48301644..08f77a24759d23d67bdc6d3375e5568e9b89e1ec 100644 (file)
@@ -13,3 +13,8 @@ The difference simply is, that this method, in contrast to http\Client::enqueue(
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 6ea8485b78c5387ab97e13c1e9782b8c9e765470..64e4d71044afcbc9a38586564a2686da72dbecc3 100644 (file)
@@ -13,4 +13,5 @@ None.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 415728e4f36e0ba642dda8f87aef8cd21e8585dd..641e1b73c989e9f09e2ed5387881f46585b0c5ff 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::addCookies() and http\Client::getCookies().
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 370441d310ba30291827ce80b2206f567d9f1fd4..50136fb05bdb5cf7994c7e1695383480b75c2139 100644 (file)
@@ -14,3 +14,6 @@ See http\Client\Curl.
 
 * http\Client, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
index d79f9926e1fdbc106b24000cccabe5db54addb33..9304c37447499ef220588e623b30d7457347798d 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::setOptions() and http\Client\Curl::$ssl options.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index e0ca8cbcdaf34706f3833bc656d6104fdac723dd..75ce5917b80bc72c419d03d45942d0ab671c5cb0 100644 (file)
@@ -1,6 +1,6 @@
-# class http\Cookie extends http\Object
+# class http\Cookie
 
-A class representing a lisdt of cookies with specific attributes.
+A class representing a list of cookies with specific attributes.
 
 ## Constants:
 
diff --git a/http/Cookie/.md b/http/Cookie/.md
deleted file mode 100644 (file)
index e69de29..0000000
index ac0cf01b61e348d0065febc0bea4358c3ceabe7d..cb63600b35ad69af5cfb8c07ad75e5b62137e909 100644 (file)
@@ -13,7 +13,8 @@ Create a new cookie list.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
 
 ## Example:
 
index e2c1396687f0bfe963d9a47c843a2dcb21211637..a32fc22a39926e035686f9cb3bb31ec6de264d07 100644 (file)
@@ -13,3 +13,7 @@ See http\Cookie::setCookie() and http\Cookie::addCookies().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 70e727f151042794d1e0167bc914a1d16b71f7e8..a261f2fa63cd19ffedc3c81c2dc682c63c444ddd 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setCookies().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 4d7716ef13e8aa3022d1b564058943a6c1225ce1..af399688fc90751baf4bb31957f99200c806e391 100644 (file)
@@ -13,3 +13,7 @@ See http\Cookie::setExtra().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index be04741931daa8446aa4eb595d34d3bac316c1f4..0693b7761065c16465430998254833d997dead53 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::addExtra().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 5b26502d25e5e943de279a2ac78a616fb4f31954..15b88d09cf5fb0908a61bfb50bbca850952bde73 100644 (file)
@@ -15,3 +15,7 @@ See http\Cookie::addCookie() and http\Cookie::setCookies().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index d518aa26c09055bc9909d24c3f14d9af0932bf3f..e3f4366ed1b47135e0a7e8805681c02ae29295ea 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::addCookies().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index ed7f8b9005e2b4f3081c104b7483cc694aa74a70..098104c7df7cefc02fe518dbf6dd3fe03d662087 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setPath().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 9878e88e6329c186f2a21f032d5cad83a1186316..736ae3ed55293322690809133597dbac36f674ff 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setMaxAge() for a safer alternative.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 6308f63f4f7563105a7e4e5e1818babce17d7cfb..ff40921cb65eb766979f039f9d3a4cdb97e3ff7c 100644 (file)
@@ -15,3 +15,7 @@ See http\Cookie::addExtra().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index b77caee8a7fb63cab5c95e24ff5005ac820a2e38..4253de76e586ad62859f19d02be480b5a2127df3 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::addExtras().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 818eb423446026a222b6c13519bee346e99ed00d..e724750efdb99730972253e172357fc292b53ca7 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::SECURE and http\Cookie::HTTPONLY constants.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 724cc5416935c998d6bd84952866c321f907d423..0840338a9c17014b987e206ce43ee75cfb0cf26f 100644 (file)
@@ -12,3 +12,7 @@ See http\Cookie::setExpires().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index fa046284d79bbf66f93ad647e406ef9321ca8eb7..216f1518d008516cf9f976236dbd595392388941 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setDomain().
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 0656593f5e9ace9bd754b1eac781210f84765ca5..b63848f6e5a2fba93aab9b60bdb54ab79c695069 100644 (file)
@@ -1,4 +1,4 @@
-# abstract class http\Encoding\Stream extends http\Object
+# abstract class http\Encoding\Stream
 
 Base class for encoding stream implementations.
 
index e87d79e3cae6dd53561f20419732d344ef0264f3..674510e5658fd83beed6d2fb7f104b8e217aaaf3 100644 (file)
@@ -1,4 +1,4 @@
-# static string http\Encoding\Stream\Dechunk::decode(string $data)
+# static string http\Encoding\Stream\Dechunk::decode(string $data[, int &$decoded_len = 0])
 
 Decode chunked encoded data.
 
@@ -6,7 +6,21 @@ Decode chunked encoded data.
 
 * string $data  
   The data to decode.
+* Optional reference int $decoded_len = 0  
+  Out parameter with the length of $data that's been decoded.
+  Should be ```strlen($data)``` if not truncated.
 
 ## Returns:
 
 * string, the decoded data.
+* string, the unencoded data.
+* string, the truncated decoded data.
+* false, if $data cannot be decoded.
+
+## Notices:
+
+* If $data does not seem to be chunked encoded.
+
+## Warnings:
+
+* If $data cannot be decoded or is truncated.
index 7a8ff70854b74512c14dc3968b93f8338fd6572b..991feb76b316459f013d2272675326701ab5a092 100644 (file)
@@ -12,3 +12,6 @@ Encode data with deflate/zlib/gzip encoding.
 ## Returns:
 
 * string, the compressed data.
+## Warnings:
+
+* If $data cannot be encoded.
index 74c504890ea2165ca89b8315779f2edebab4cbc0..2eaf7a1b0de51efa7e77b25e4a5ee4bc524ed33b 100644 (file)
@@ -10,3 +10,7 @@ Decode deflate/zlib/gzip encoded data.
 ## Returns:
 
 * string, the uncompressed data.
+
+## Warnings:
+
+* If $data cannot be decoded.
index baf89232074ab1d9ee8c3a9242d490f34ab9e011..0ce9701a50472f0c7dae6912a2934067853d0e1d 100644 (file)
@@ -9,4 +9,5 @@ Base constructor for encoding stream implementations.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 3ec8e1239fcd7cdf9f1625f8bd20920b4b462576..e7ca08f47cbd64b76deaa83fb47e5adaf8868832 100644 (file)
@@ -10,3 +10,7 @@ None.
 ## Returns:
 
 * string, any pending data.
+
+## Warnings:
+
+* If the encoding stream is in an invalid state.
index 5daea861a54b8cb147230474315fd0ebd26f2144..620a04b4276868ae332b946cc56d09f61a7bb942 100644 (file)
@@ -10,3 +10,7 @@ None.
 ## Returns:
 
 * string, any pending data.
+
+## Warnings:
+
+* If the encoding stream is in an invalid state.
index 7bcdd9bbb22f450b47e6e9a4ad3a34be98d92bad..fd81eaf9cb19081a8e397e5d6819ca82d72f3c15 100644 (file)
@@ -10,3 +10,7 @@ Update the encoding stream with more input.
 ## Returns:
 
 * string, processed data.
+
+## Warnings:
+
+* If the encoding stream is in an invalid state.
index e33774a845a2296ebf57602cc9b181d9074ea3ea..5571b9df34a286dffd63652feebf69ec42dfd8e4 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Env extends http\Object
+# class http\Env
 
 The http\Env class provides static methods to manipulate and inspect the server's current request's HTTP environment.
 
index 0e5707245e52476b458bc46d80b0e88be01e10c2..19ab5a1633d25d82d2323b2f89922f0d7a9a0ee1 100644 (file)
@@ -10,3 +10,7 @@ It also compiles an array of uploaded files ($\_FILES) more comprehensive than t
 
 None.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index fc2e6d942c9eb13f0864fe82387508c8e161db5a..6c866442c4b0135887b6fb327b93e2daf1e39bb7 100644 (file)
@@ -8,7 +8,8 @@ None.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
index 0ab810c287a08727dbf3fb6a941e3c84f222d26c..31e2dec1e8b2ddc937e1ba0fc7465d63c7497c1f 100644 (file)
@@ -10,3 +10,7 @@ Make suggestions to the client how it should cache the response.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 0b4a5514838920bd5a2012ff728c4153c19e377c..e03dd3c5dc48f560edaf7c97b5ca4cd9f88fadff 100644 (file)
@@ -11,6 +11,10 @@ Set the reponse's content disposition parameters.
 
 * http\Env\Response, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+
 ## Example:
 
     <?php ob_end_Clean();chdir(__DIR__."/../../..");
index 3b3d612f8a0014a6c53e30b46ff09115ba5df16b..693e1a005f934e0262dd505f723ad1a165c62ee5 100644 (file)
@@ -11,3 +11,7 @@ The response will be compressed if the client indicates support and wishes that.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 78674dfa317a80f633876c41f36382d79c2acfe9..79ca97e92c1e4322c731150713bb00c5033b6429 100644 (file)
@@ -10,3 +10,7 @@ Set the MIME content type of the response.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Env\InvalidArgumentException
index 83cb5bf1eace7eef5764c70b7eb410d881572928..8d4b937774dca0a006033b2aa59fce879a74c437 100644 (file)
@@ -11,6 +11,10 @@ Override the environment's request.
 
 * http\Env\Response, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+
 ## Example:
 
     <?php
index b8d0e66bc291461861e0dd8dd92a755ee570febe..f71c80bdcd17b6a322a6d7b7746543122eec5f84 100644 (file)
@@ -12,3 +12,7 @@ Set a custom ETag.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 17f433756976e0f0f093a98d2579b2d3a55b914b..a057605d6bc20cfee9d964ffa982fa1b416ed39d 100644 (file)
@@ -12,3 +12,7 @@ Set a custom last modified time stamp.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index eaadc0d5058301155bd8d13ff4f9913c9f6e2d4a..4fcd24a3217b13b1aee6f9ef088e8e7a5ef152af 100644 (file)
@@ -13,4 +13,5 @@ Retreive the current HTTP request's body.
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 4f6609eb40d2743e1564301931d97a07d9df028a..e27b813185bbfc59de507031979b8718b61a8ec4 100644 (file)
@@ -1,27 +1,29 @@
-# class http\Exception extends Exception
+# interface http\Exception
 
-The http extension's Exception.
+The http extension's Exception interface.
 
-## Constants:
+Use it to catch any Exception thrown by pecl/http.
 
-* E_UNKNOWN  
-* E_RUNTIME  
-* E_INVALID_PARAM  
-* E_HEADER  
-* E_MALFORMED_HEADERS  
-* E_MESSAGE  
-* E_MESSAGE_TYPE  
-* E_MESSAGE_BODY  
-* E_ENCODING  
-* E_CLIENT  
-* E_CLIENT_POOL  
-* E_CLIENT_DATASHARE  
-* E_SOCKET  
-* E_RESPONSE  
-* E_URL  
-* E_QUERYSTRING  
-* E_COOKIE  
+The individual exception classes extend their equally named native PHP extensions, if such exist, and implement this empty interface. For example the http\Exception\BadMethodCallException extends SPL's BadMethodCallException.
 
 ## Properties:
 
 None.
+
+## Example:
+
+    <?php
+    $req = new http\Env\Request;
+    
+    try {
+        $messages = $req->splitMultipartBody();
+    } catch (http\Exception\BadMethodCallException $e) {
+        // doh, no multipart message
+    } catch (http\Exception\BadMessageException $e) {
+        // failure while parsing
+    } catch (http\Exception $e) {
+        // here we used the interface to catch any http\Exception
+    } catch (Exception $e) {
+        // catch any other exception (unlikely, though)
+    }
+    ?>
diff --git a/http/Exception/BadConversionException.md b/http/Exception/BadConversionException.md
new file mode 100644 (file)
index 0000000..506f62e
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadConversionException extends DomainException implements http\Exception
+
+A bad conversion (e.g. character conversion) was encountered.
diff --git a/http/Exception/BadHeaderException.md b/http/Exception/BadHeaderException.md
new file mode 100644 (file)
index 0000000..a8faafc
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadHeaderException extends DomainException implements http\Exception
+
+A bad HTTP header was encountered.
diff --git a/http/Exception/BadMessageException.md b/http/Exception/BadMessageException.md
new file mode 100644 (file)
index 0000000..8397c4d
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadMessageException extends DomainException implements http\Exception
+
+A bad HTTP message was encountered.
diff --git a/http/Exception/BadMethodCallException.md b/http/Exception/BadMethodCallException.md
new file mode 100644 (file)
index 0000000..fcd7b90
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadMethodCallException extends BadMethodCallException implements http\Exception
+
+A method was called on an object, which was in an invalid or unexpected state.
diff --git a/http/Exception/BadQueryStringException.md b/http/Exception/BadQueryStringException.md
new file mode 100644 (file)
index 0000000..359b4fd
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadQueryStringException extends DomainException implements http\Exception
+
+A bad querystring was encountered.
diff --git a/http/Exception/BadUrlException.md b/http/Exception/BadUrlException.md
new file mode 100644 (file)
index 0000000..2305e68
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadUrlException extends DomainException implements http\Exception
+
+A bad HTTP URL was encountered.
diff --git a/http/Exception/InvalidArgumentException.md b/http/Exception/InvalidArgumentException.md
new file mode 100644 (file)
index 0000000..9276c81
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\InvalidArgumentException extends InvalidArgumentException implements http\Exception
+
+One or more invalid arguments were passed to a method.
diff --git a/http/Exception/RuntimeException.md b/http/Exception/RuntimeException.md
new file mode 100644 (file)
index 0000000..b41a4d5
--- /dev/null
@@ -0,0 +1,4 @@
+# class http\Exception\RuntimeException extends RuntimeException implements http\Exception
+
+A generic runtime exception.
+
diff --git a/http/Exception/UnexpectedValueException.md b/http/Exception/UnexpectedValueException.md
new file mode 100644 (file)
index 0000000..0da97fa
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\UnexpectedValueException extends UnexpectedValueException implements http\Exception
+
+An unexpected value was encountered.
index 6261bae2b0ab949e46ddbc98686993f5a9d2f087..59ad426f1ba88801fea281b8c788fa2e573df0dc 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Header extends http\Object implements Serializable
+# class http\Header implements Serializable
 
 The http\Header class provides methods to manipulate, match, negotiate and serialize HTTP headers.
 
index 4e2c5a1620effd28bcec3a9f2cf2f62773c86def..84c7d82bdfde9eb048dc21f6603dd5c45a593379 100644 (file)
@@ -12,3 +12,8 @@ Parse HTTP headers.
 ## Returns:
 
 * array of parsed headers, where the elements are instances of $header_class if specified.
+* false, if parsing fails.
+
+## Warnings:
+
+* If the header parser fails.
index 3a40de6425945ce4f4e633fc01238588ce35a007..91e356635fd93662e916442038aba5f8ca0b6178 100644 (file)
@@ -7,3 +7,6 @@ Implements Serializable.
 * string $serialized  
   The serialized HTTP header (i.e. "Name: value")
 
+## Warnings:
+
+* If the header parser fails.
index cdb4c30e634965a6e934e3a9b4aa6007b938cb69..ca48ff2ae7d677511f429025f0e7f81f19e05cbd 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Message extends http\Object implements Countable, Serializable, Iterator
+# class http\Message implements Countable, Serializable, Iterator
 
 The message class builds the foundation for any request and response message.
 See http\Client\Request and http\Client\Response, as well as http\Env\Request and http\Env\Response.
index 01c3479819a17685641995cbab04a85778d79d45..ef684ad3f8fc87145efc740d04145d36218ab815 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Message\Body extends http\Object implements Serializable
+# class http\Message\Body implements Serializable
 
 The message body, represented as a PHP (temporary) stream.
 
index 2ef43e011075cb257a8a015e8b564dc1b0fd808c..0a144c6c5f5ae49786c2cb2b636a612843f6347c 100644 (file)
@@ -9,7 +9,8 @@ Create a new message body, optionally referencing $stream.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
index d71fda90b43b81103cc7a2cb23704c901b546fd0..19e3b6cda2d739943b905fe953c1dffc6402088a 100644 (file)
@@ -47,6 +47,11 @@ As you can see, a file structure must contain a "file" entry, which holds a file
 
 * http\Message\Body, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
+
 ## Example:
 
     <?php
index 8a2f8a743c2c71ed345c736641ec168e71efecc7..424a91b4537ce335be51421508f8315168734959 100644 (file)
@@ -11,6 +11,11 @@ Add a part to a multipart body.
 
 * http\Message\Body, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
+
 ## Example:
 
     <?php
index 5cf06010e461f6176984c95502c8efbe318bbf21..5503e4543038f0ddcc83e18e559fa9a40d7fed92 100644 (file)
@@ -12,6 +12,7 @@ Append plain bytes to the message body.
 * http\Message\Body, self.
 
 
-## Warnings:
+## Throws:
 
-* E_MESSAGE_BODY, if writing to the body fails.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 61f7ef0f657af86d8f132546c2b8ff8d1d98ef67..f61f50d6ca9eefed887831330aea2535fec68f96 100644 (file)
@@ -11,4 +11,5 @@ Create a new HTTP message.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMessageException
index fa12d44fb7c7e9235d366d1cbc7c3971ad81d17a..965b54d42d47dbe9d37f46f4cfe627ace0058971 100644 (file)
@@ -12,4 +12,4 @@ None.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException.
index 013f22a0b2a5c49504de6a1c3879fea89ecb2571..d95d9c26a5bd6814fd23131bb3baabc978b55861 100644 (file)
@@ -13,4 +13,5 @@ None.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueEcxeption
index 08efe967a087e83d804bff9a89caefe78fedacfa..62bddc8142c019b0cdcad472118985d1976ca99e 100644 (file)
@@ -16,7 +16,7 @@ Retrieve a single header, optionally hydrated into a http\Header extending class
 
 ## Warnings:
 
-* E_INVALID_PARAM, if $into_class is not a descendant of http\Header.
+* If $into_class is specified but is not a descendant of http\Header.
 
 ## Example:
 
index ace45d5f1f167dc2217af67170cde79c30a8ab04..f1170d4f82782d606dc55b28f0ba9de6b06df3fb 100644 (file)
@@ -13,7 +13,8 @@ None.
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
 
 
 ## Example:
index 14c73b6fd7682cf043fd0ff9424f3e043f26f502..bae3345c24df5ffc74acd10419fb1939ead94084 100644 (file)
@@ -12,6 +12,6 @@ None.
 * string, the request method.
 * false, if the message was not of type request.
 
-## Notices:
+## Warnings:
 
-* E_MESSAGE_TYPE, if the message is not of type request.
+* If the message is not of type request.
index 0c0069c32a52fc6184e6fc59252ae742b92f20b0..c4d0e3266c3a5ecdad63015415e1bdeea04da1f9 100644 (file)
@@ -12,6 +12,6 @@ None.
 * string, the request URL; usually the path and the querystring.
 * false, if the message was not of type request.
 
-## Notices:
+## Warnings:
 
-* E_MESSAGE_TYPE, if the message is not of type request.
+* If the message is not of type request.
index 83032036c7ec75e6a5743f94101872375da61f19..519c09d736b7e55cc842a8854aa5f8d1937b89a6 100644 (file)
@@ -12,6 +12,6 @@ None.
 * int, the response status code.
 * false, if the message is not of type response.
 
-## Notices:
+## Warnings:
 
-* E_MESSAGE_TYPE, if the message is not of type response.
+* If the message is not of type response.
index d90cee1b48e63fefd477c34471c3aecd09d9dfdc..7717eaf24683af7bda32eb307a65e45b2bc7a87e 100644 (file)
@@ -12,6 +12,6 @@ None.
 * string, the response status phrase.
 * false, if the message is not of type response.
 
-## Notices:
+## Warnings:
 
-* E_MESSAGE_TYPE, if the message is not of type response.
+* If the message is not of type response.
index e010901580399ad4001c94050b5f1d55f742ff74..7bc88df959f3833e90a1ef18fd1eb45136133884 100644 (file)
@@ -17,4 +17,5 @@ Prepend message(s) $message to this message, or the top most message of this mes
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 12030e906ad982debe28b51fa1de2fe482578c75..9189589b4ca2fcda68fe6301b07a290fb9105722 100644 (file)
@@ -13,3 +13,7 @@ None.
 ## Returns:
 
 * http\Message, the other end of the message chain.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 9cd55f8aa3da3c044e844b0cbcbd2ed4d145f1d9..9baa0dc898823f705250e3c403563fe10c7fa8c7 100644 (file)
@@ -11,3 +11,8 @@ See http\Message::getBody() and http\Message::addBody().
 ## Returns:
 
 * http\Message, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index ee9ab0ab685bf7dabf1b57d75eb43427b122061d..06bf2a7a685a9f4fc90ee71352e1a3ccd4067e03 100644 (file)
@@ -14,11 +14,12 @@ See http\Message::getHttpVersion().
 
 ## Notices:
 
-* E_MALFORMED_HEADERS, if the version separator is non-standard.
+* If a non-standard version separator is encounted.
 
-## Warnings:
+## Throws:
 
-* E_MALFORMED_HEADERS, if the version could not be parsed.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadHeaderException
 
 ## Example:
 
index 36e63fa5369a89388f0c51ed26fba60fe400869f..820de0262f9179d5cdf9461e329d96c7f7ad4a22 100644 (file)
@@ -12,9 +12,10 @@ See http\Message::getInfo().
 
 * http\Message, self.
 
-## Warnings:
+## Throws:
 
-* E_MALFORMED_HEADERS, if the message information could not be parsed.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadHeaderException
 
 ## Format of the message info:
 
index a15e9c12222ba21e3d4141ade8b7b523c8b13ccb..2ec295eef7c8ddad8d9505e740d08771a47d91d8 100644 (file)
@@ -11,12 +11,8 @@ See http\Message::getRequestMethod() and http\Message::setRequestUrl().
 ## Returns:
 
 * http\Message, self.
-* false, if the message was not of type request.
 
-## Notices:
+## Throws:
 
-* E_MESSAGE_TYPE, if the message is not of type request.
-
-## Warnings:
-
-* E_INVALID_PARAM, if the method is of zero length.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
index 9c6663debb05f87a9a45e179ebdc2252ab2087eb..30e4a7dccd097dc53d74bda8806f218a5465025d 100644 (file)
@@ -11,15 +11,11 @@ See http\Message::getRequestUrl() and http\Message::setRequestMethod().
 ## Returns:
 
 * http\Message, self.
-* false, if the message was not of type request.
 
-## Notices:
+## Throws:
 
-* E_MESSAGE_TYPE, if the message is not of type request.
-
-## Warnings:
-
-* E_INVALID_PARAM, if the url is of zero length.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
 
 ## Example:
 
index 58c8d82272922dfb5a06235b316454ed861a3709..71ff8f05f1faa2148480eb8c7af26686088f4a90 100644 (file)
@@ -1,15 +1,22 @@
-# http\Message http\Message::setResponseCode(int $response_code)
+# http\Message http\Message::setResponseCode(int $response_code[, bool $strict = true])
 
 Set the response status code.
 See http\Message::getResponseCode() and http\Message::setResponseStatus().
 
+> **Note:** This method also resets the response status phrase to the default for that code.
+
 ## Params:
 
 * int $response_code  
   The response code.
+* Optional bool $strict = true  
+  Whether to check that the response code is between 100 and 599 inclusive.
 
 ## Returns:
 
 * http\Message, self.
-* false, if the message is not of type response.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
index b1ba28602d50dc18c8bc3705509c92df824f76b8..c67fa26044416d247d91dfba6f076eb7591e3c31 100644 (file)
@@ -11,12 +11,11 @@ See http\Message::getResponseStatus() and http\Message::setResponseCode().
 ## Returns:
 
 * http\Message, self.
-* false, if the message is not of type response.
 
-## Notice:
-
-* E_MESSAGE_TYPE, if the message is not of type response.
+## Throws:
 
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
 
 ## Example:
 
index 10f2ac63d3171e47f4c312b2084ef7705d772c44..8e59e4805a79d5b9fc95652cf9372fed2a38f500 100644 (file)
@@ -11,6 +11,12 @@ None.
 
 * http\Message, a message chain of all messages of the multipart body.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\BadMessageException
+
 ## Example:
 
     <?php
index 1648ced773fe537c13324d3d7f01f56908afde47..ff1e4e5ec43bb509ca4fd42acc2d999060f61dd2 100644 (file)
@@ -7,3 +7,6 @@ Implements Serializable.
 * string $data  
   The serialized message.
 
+## Errors:
+
+* If the message could not be unserialized.
diff --git a/http/Object.md b/http/Object.md
deleted file mode 100644 (file)
index a04b873..0000000
+++ /dev/null
@@ -1,19 +0,0 @@
-# abstract class http\Object
-
-The http\Object class provides an error handling foundation for the rest of the http extension's framwework.
-
-## Constants:
-
-* EH_NORMAL  
-  Normal error handling.
-* EH_SUPPRESS  
-  Suppress errors.
-* EH_THROW  
-  Throw exceptions on errors.
-
-## Properties:
-
-* static protected $defaultErrorHandling = NULL  
-  Static default error handling.
-* protected $errorHandling = NULL  
-  Per instance error handling.
diff --git a/http/Object/getDefaultErrorHandling.md b/http/Object/getDefaultErrorHandling.md
deleted file mode 100644 (file)
index 936d36e..0000000
+++ /dev/null
@@ -1,8 +0,0 @@
-# static int http\Object::getDefaultErrorHandling()
-
-Retreive the http extension's global default error handling.
-
-## Returns:
-
-* int, the error handling. See http\Object::EH_* constants.
-* NULL, when error handling is not set.
diff --git a/http/Object/getErrorHandling.md b/http/Object/getErrorHandling.md
deleted file mode 100644 (file)
index c44dcfa..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-# int http\Object::getErrorHandling()
-
-Retrieve the currently set instance error handling.
-
-## Params:
-
-None.
-
-## Returns:
-
-* int, the current error handling. See http\Object::EH_* constants.
-
diff --git a/http/Object/setDefaultErrorHandling.md b/http/Object/setDefaultErrorHandling.md
deleted file mode 100644 (file)
index 950af94..0000000
+++ /dev/null
@@ -1,17 +0,0 @@
-# static void http\Object::setDefaultErrorHandling(int $eh)
-
-Set the http extension's global default error handling.
-
-## Params:
-
-* int $eh  
-  The error handling. See http\Object::EH_* constants.
-  
-## Throws:
-
-* http\Exception  
-  When http\Object::EH_THROW is in effect.
-  
-## Warnings:
-
-* E_RUNTIME, if $eh is an unknown error handling.
diff --git a/http/Object/setErrorHandling.md b/http/Object/setErrorHandling.md
deleted file mode 100644 (file)
index 09763ef..0000000
+++ /dev/null
@@ -1,21 +0,0 @@
-# http\Object http\Object::setErrorHandling(int $eh)
-
-Set instance error handling.
-
-## Params:
-
-* int $eh  
-  The error handling this instance should enforce.
-
-## Returns:
-
-* http/Object, self.
-
-## Throws:
-
-* http\Exception  
-  When http\Object::EH_THROW is in effect.
-
-## Warnings:
-
-* E_RUNTIME, if $eh is an unknown error handling code.
diff --git a/http/Object/triggerError.md b/http/Object/triggerError.md
deleted file mode 100644 (file)
index 72ba2f2..0000000
+++ /dev/null
@@ -1,13 +0,0 @@
-# void http\Object::triggerError(int $eh, int $code, string $error)
-
-Trigger an error with the specified error handling.
-
-## Params:
-
-* int $eh  
-  The error handling to use. See http\Object::EH_* constants.
-* int $code  
-  The error code.
-* string $error  
-  The error message.
-
index b45d0c64840f8bb55c640fa0a191ab2519fa5246..d8bf3b77b691e3a690cb18e937b70a78e297d2cf 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Params extends http\Object implements ArrayAccess
+# class http\Params implements ArrayAccess
 
 Parse, interpret and compose HTTP (header) parameters.
 
@@ -11,7 +11,7 @@ Parse, interpret and compose HTTP (header) parameters.
 * DEF_VAL_SEP  
   The default value separator ("=").
 * COOKIE_PARAM_SEP  
-  TBD
+  Empty param separator to parse cookies.
 * PARSE_RAW  
   Do not interpret the parsed parameters.
 * PARSE_DEFAULT  
index ff2a296c3dbb845fc47e80efb7823c520eb90c9a..b1110c8b8f017e8d468dc81803cca1b344bd2302 100644 (file)
@@ -17,5 +17,6 @@ Instantiate a new HTTP (header) parameter set.
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
 
index 9541a35fd1857ce89ed7c486050a658a0cfeb6ab..9f4f0d198e02d0eb78217f1b287ceed1dc40e447 100644 (file)
@@ -1,4 +1,4 @@
-# class http\QueryString extends http\Object implements Serializable, ArrayAccess, IteratorAggregate
+# class http\QueryString implements Serializable, ArrayAccess, IteratorAggregate
 
 The http\QueryString class provides versatile facilities to retrieve, use and manipulate query strings and form data.
 
index 8a1140b7844f2af81e9e729e7dc97b7d5529e8ee..90b42878ffbef6280a3df5cccdfb32a09de8c29a 100644 (file)
@@ -9,7 +9,7 @@ Create an independent querystring instance.
   
 ## Throws:
 
-* http\Exception
+* http\Exception\BadQueryStringException
 
 ## Example:
 
index 1db996ae10eb89bf640e58154e6b0c9e4aea1ef2..24529d0573d66839987b155c1ff3f203bc629073 100644 (file)
@@ -12,4 +12,4 @@ None.
 
 ## Throws:
 
-* http\Exception
+* http\Exception\UnexpectedValueException
index ab37865f720a24e2e8cdc97263ac880e206324c6..ac140a1f381db3751051c18f7eb2bf2094f8d74f 100644 (file)
@@ -12,4 +12,5 @@ None.
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* InvalidArgumentException
index a1ba5b83016e63791c50ca878a540ac99c36ba6c..83068e94109446e71193d13415e11ae5644306fb 100644 (file)
@@ -3,14 +3,17 @@
 Set additional $params to a clone of this instance. 
 See http\QueryString::set().
 
-> **Note:** This method returns a clone (copy) of this instance
+> **Note:** This method returns a clone (copy) of this instance.
 
 ## Params:
 
 * mixed $params = NULL  
   Additional params as object, array or string to parse.
 
-
 ## Returns:
 
 * http\QueryString, clone.
+
+## Throws:
+
+* http\Exception\BadQueryStringException
index baeb2f63c24db10cc1de5a6ceb0e7f47143be12b..4087b40dc92e31632907818aa3ab84cb3ee8b12a 100644 (file)
@@ -17,4 +17,5 @@ Translate character encodings of the querystring with ext/iconv.
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\BadConversionException
index 8069c342da1c190e5b2c14d24236ebcf14d9b9d2..b9ef47f11586b36c53bcf9bfc7f048834a39efd9 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Url extends http\Object
+# class http\Url
 
 The http\Url class provides versatile means to parse, construct and manipulate URLs.
 
index 6d6730639644760f45600d9a02733f153065ffa8..bf6629660c44d20626cb62c58b47f2711008edec 100644 (file)
@@ -13,5 +13,6 @@ Create an instance of an http\URL.
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\BadUrlException
 
index 52b1f536c812f19e0855b2356a12f84a8ef71562..9fab9a879ead9d1cef2cffdeed03f1d2b994a8ba 100644 (file)
@@ -14,3 +14,9 @@ Clone this URL and apply $parts to the cloned URL.
 ## Returns:
 
 * http\Url, clone.
+
+## Throws:
+
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadUrlException
index 41d9e856fbb6023333de2cdc404d79884e7f74b3..e0f3ccf5eda23820818a7e2e73188c17797a59f9 100644 (file)
--- a/index.js
+++ b/index.js
@@ -40,6 +40,11 @@ function type(s, nn) {
        case "stdClass":
        case "Exception":
        case "ErrorException":
+       case "RuntimeException":
+       case "UnexpectedValueException":
+       case "DomainException":
+       case "InvalidArgumentException":
+       case "BadMethodCallException":
        case "Closure":
        case "Generator":
        case "Countable":