Prepare v0.5.0 release

Author: clue

CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## 0.5.0 (2016-03-19)
+
+* Feature / BC break: Support Connector without DNS
+  (#46 by @clue)
+
+  BC break: The `Connector` class now serves as a BC layer only.
+  The `TcpConnector` and `DnsConnector` classes replace its functionality.
+  If you're merely *using* this class, then you're *recommended* to upgrade as
+  per the below snippet – existing code will still work unchanged.
+  If you're `extend`ing the `Connector` (generally not recommended), then you
+  may have to rework your class hierarchy.
+
+  ```php
+// old (still supported, but marked deprecated)
+$connector = new Connector($loop, $resolver);
+
+// new equivalent
+$connector = new DnsConnector(new TcpConnector($loop), $resolver);
+
+// new feature: supports connecting to IP addresses only
+$connector = new TcpConnector($loop);
+```
+
+* Feature: Add socket and SSL/TLS context options to connectors
+  (#52 by @clue)
+
+* Fix: PHP 5.6+ uses new SSL/TLS context options
+  (#61 by @clue)
+
+* Fix: Move SSL/TLS context options to SecureConnector
+  (#43 by @clue)
+
+* Fix: Fix error reporting for invalid addresses
+  (#47 by @clue)
+
+* Fix: Close stream resource if connection fails
+  (#48 by @clue)
+
+* First class support for PHP 5.3 through PHP 7 and HHVM
+  (#53, #54 by @clue)
+
+* Add integration tests for SSL/TLS sockets
+  (#62 by @clue)
+
 ## 0.4.4 (2015-09-23)
 
 * Feature: Add support for Unix domain sockets (UDS) (#41 by @clue)

README.md

@@ -138,6 +138,25 @@ $connector->create('/tmp/demo.sock')->then(function (React\Stream\Stream $stream
 $loop->run();
 ```
 
+## Install
+
+The recommended way to install this library is [through Composer](http://getcomposer.org).
+[New to Composer?](http://getcomposer.org/doc/00-intro.md)
+
+This will install the latest supported version:
+
+```bash
+$ composer require react/socket-client:^0.5
+```
+
+If you care a lot about BC, you may also want to look into supporting legacy versions:
+
+```bash
+$ composer require "react/socket-client:^0.5||^0.4||^0.3"
+```
+
+More details and upgrade guides can be found in the [CHANGELOG](CHANGELOG.md).
+
 ## Tests
 
 To run the test suite, you need PHPUnit. Go to the project root and run:

composer.json

@@ -15,11 +15,6 @@
             "React\\SocketClient\\": "src"
         }
     },
-    "extra": {
-        "branch-alias": {
-            "dev-master": "0.4-dev"
-        }
-    },
     "require-dev": {
         "clue/block-react": "~1.0"
     }