Add documentation for newInstance

Author: tomphp

CHANGELOG.md

@@ -4,9 +4,13 @@ This project adheres to [Semantic Versioning](http://semver.org/).<Paste>
 
 ## [Unreleased]
 
+## [0.2.2] - 2016-03-18
+### Added
+- `newInstance()`
+
 ## [0.2.1] - 2016-03-13
 ### Added
-- `callStatic`
+- `callStatic()`
 
 ## [0.2.0] - 2016-02-07
 ### Added

README.md

@@ -214,3 +214,30 @@ function ($value) {
     return strpos('Tom: My name is Tom', $value, 4);
 }
 ```
+
+#### T\newInstance(string $className, array $arguments = [__])
+
+```php
+T\newInstance(Widget::class);
+
+// Is equivalent to:
+
+function ($value) {
+    return new Widget($value);
+}
+```
+
+You can also provide a list of arguments using `__` as the placeholder for where
+you want the value inserted:
+
+```php
+use const TomPHP\Transform\__;
+
+T\newInstance(Widget, ['first', __, 'last']);
+
+// Is equivalent to:
+
+function ($value) {
+    return new Widget('first', $value, 'last');
+}
+```