Improve documentation to use fully-qualified function names

Author: clue

README.md

@@ -22,18 +22,26 @@ for [ReactPHP](https://reactphp.org/).
 This lightweight library consists only of a few simple functions.
 All functions reside under the `React\Promise\Stream` namespace.
 
-The below examples assume you use an import statement similar to this:
+The below examples assume refer to them with their fully-qualified names like this:
 
 ```php
-use React\Promise\Stream;
+React\Promise\Stream\buffer(…);
+```
 
-Stream\buffer(…);
+As of PHP 5.6+ you can also import each required function into your code like this:
+
+```php
+use function React\Promise\Stream\buffer;
+
+buffer(…);
 ```
 
-Alternatively, you can also refer to them with their fully-qualified name:
+Alternatively, you can also use an import statement similar to this:
 
 ```php
-\React\Promise\Stream\buffer(…);
+use React\Promise\Stream;
+
+Stream\buffer(…);
 ```
 
 ### buffer()
@@ -44,7 +52,7 @@ create a `Promise` which resolves with the stream data buffer.
 ```php
 $stream = accessSomeJsonStream();
 
-Stream\buffer($stream)->then(function ($contents) {
+React\Promise\Stream\buffer($stream)->then(function ($contents) {
     var_dump(json_decode($contents));
 });
 ```
@@ -64,7 +72,7 @@ will be rejected with an `\OverflowException`.
 ```php
 $stream = accessSomeToLargeStream();
 
-Stream\buffer($stream, 1024)->then(function ($contents) {
+React\Promise\Stream\buffer($stream, 1024)->then(function ($contents) {
     var_dump(json_decode($contents));
 }, function ($error) {
     // Reaching here when the stream buffer goes above the max size,
@@ -81,7 +89,7 @@ create a `Promise` which resolves once the given event triggers for the first ti
 ```php
 $stream = accessSomeJsonStream();
 
-Stream\first($stream)->then(function ($chunk) {
+React\Promise\Stream\first($stream)->then(function ($chunk) {
     echo 'The first chunk arrived: ' . $chunk;
 });
 ```
@@ -109,7 +117,7 @@ create a `Promise` which resolves with an array of all the event data.
 ```php
 $stream = accessSomeJsonStream();
 
-Stream\all($stream)->then(function ($chunks) {
+React\Promise\Stream\all($stream)->then(function ($chunks) {
     echo 'The stream consists of ' . count($chunks) . ' chunk(s)';
 });
 ```
@@ -141,7 +149,7 @@ be piped to the output stream.
 //$promise = someFunctionWhichResolvesWithAStream();
 $promise = startDownloadStream($uri);
 
-$stream = Stream\unwrapReadable($promise);
+$stream = React\Promise\Stream\unwrapReadable($promise);
 
 $stream->on('data', function ($data) {
     echo $data;
@@ -159,7 +167,7 @@ an `error` event and close:
 ```php
 $promise = startDownloadStream($invalidUri);
 
-$stream = Stream\unwrapReadable($promise);
+$stream = React\Promise\Stream\unwrapReadable($promise);
 
 $stream->on('error', function (Exception $error) {
     echo 'Error: ' . $error->getMessage();
@@ -178,7 +186,7 @@ You can `close()` the resulting stream at any time, which will either try to
 ```php
 $promise = startDownloadStream($uri);
 
-$stream = Stream\unwrapReadable($promise);
+$stream = React\Promise\Stream\unwrapReadable($promise);
 
 $loop->addTimer(2.0, function () use ($stream) {
     $stream->close();
@@ -200,7 +208,7 @@ have written to the proxy will be forwarded transparently to the inner stream.
 //$promise = someFunctionWhichResolvesWithAStream();
 $promise = startUploadStream($uri);
 
-$stream = Stream\unwrapWritable($promise);
+$stream = React\Promise\Stream\unwrapWritable($promise);
 
 $stream->write('hello');
 $stream->end('world');
@@ -217,7 +225,7 @@ an `error` event and close:
 ```php
 $promise = startUploadStream($invalidUri);
 
-$stream = Stream\unwrapWritable($promise);
+$stream = React\Promise\Stream\unwrapWritable($promise);
 
 $stream->on('error', function (Exception $error) {
     echo 'Error: ' . $error->getMessage();
@@ -236,7 +244,7 @@ You can `close()` the resulting stream at any time, which will either try to
 ```php
 $promise = startUploadStream($uri);
 
-$stream = Stream\unwrapWritable($promise);
+$stream = React\Promise\Stream\unwrapWritable($promise);
 
 $loop->addTimer(2.0, function () use ($stream) {
     $stream->close();

src/functions.php

@@ -14,7 +14,7 @@
  * ```php
  * $stream = accessSomeJsonStream();
  *
- * Stream\buffer($stream)->then(function ($contents) {
+ * React\Promise\Stream\buffer($stream)->then(function ($contents) {
  *     var_dump(json_decode($contents));
  * });
  * ```
@@ -34,7 +34,7 @@
  * ```php
  * $stream = accessSomeToLargeStream();
  *
- * Stream\buffer($stream, 1024)->then(function ($contents) {
+ * React\Promise\Stream\buffer($stream, 1024)->then(function ($contents) {
  *     var_dump(json_decode($contents));
  * }, function ($error) {
  *     // Reaching here when the stream buffer goes above the max size,
@@ -97,7 +97,7 @@ function buffer(ReadableStreamInterface $stream, $maxLength = null)
  * ```php
  * $stream = accessSomeJsonStream();
  *
- * Stream\first($stream)->then(function ($chunk) {
+ * React\Promise\Stream\first($stream)->then(function ($chunk) {
  *     echo 'The first chunk arrived: ' . $chunk;
  * });
  * ```
@@ -170,7 +170,7 @@ function first(EventEmitterInterface $stream, $event = 'data')
  * ```php
  * $stream = accessSomeJsonStream();
  *
- * Stream\all($stream)->then(function ($chunks) {
+ * React\Promise\Stream\all($stream)->then(function ($chunks) {
  *     echo 'The stream consists of ' . count($chunks) . ' chunk(s)';
  * });
  * ```
@@ -251,7 +251,7 @@ function all(EventEmitterInterface $stream, $event = 'data')
  * //$promise = someFunctionWhichResolvesWithAStream();
  * $promise = startDownloadStream($uri);
  *
- * $stream = Stream\unwrapReadable($promise);
+ * $stream = React\Promise\Stream\unwrapReadable($promise);
  *
  * $stream->on('data', function ($data) {
  *     echo $data;
@@ -269,7 +269,7 @@ function all(EventEmitterInterface $stream, $event = 'data')
  * ```php
  * $promise = startDownloadStream($invalidUri);
  *
- * $stream = Stream\unwrapReadable($promise);
+ * $stream = React\Promise\Stream\unwrapReadable($promise);
  *
  * $stream->on('error', function (Exception $error) {
  *     echo 'Error: ' . $error->getMessage();
@@ -288,7 +288,7 @@ function all(EventEmitterInterface $stream, $event = 'data')
  * ```php
  * $promise = startDownloadStream($uri);
  *
- * $stream = Stream\unwrapReadable($promise);
+ * $stream = React\Promise\Stream\unwrapReadable($promise);
  *
  * $loop->addTimer(2.0, function () use ($stream) {
  *     $stream->close();
@@ -316,7 +316,7 @@ function unwrapReadable(PromiseInterface $promise)
  * //$promise = someFunctionWhichResolvesWithAStream();
  * $promise = startUploadStream($uri);
  *
- * $stream = Stream\unwrapWritable($promise);
+ * $stream = React\Promise\Stream\unwrapWritable($promise);
  *
  * $stream->write('hello');
  * $stream->end('world');
@@ -333,7 +333,7 @@ function unwrapReadable(PromiseInterface $promise)
  * ```php
  * $promise = startUploadStream($invalidUri);
  *
- * $stream = Stream\unwrapWritable($promise);
+ * $stream = React\Promise\Stream\unwrapWritable($promise);
  *
  * $stream->on('error', function (Exception $error) {
  *     echo 'Error: ' . $error->getMessage();
@@ -352,7 +352,7 @@ function unwrapReadable(PromiseInterface $promise)
  * ```php
  * $promise = startUploadStream($uri);
  *
- * $stream = Stream\unwrapWritable($promise);
+ * $stream = React\Promise\Stream\unwrapWritable($promise);
  *
  * $loop->addTimer(2.0, function () use ($stream) {
  *     $stream->close();