fabpot/PHP-CS-Fixer — pull request #501 by GrahamCampbell (2014-08-31 12:29:20+00:00)
Title: Fixed Some Docblocks

Just to keep everything the same:
* All short descriptions should end in `.`, `!`, or `?`, and should be followed by a blank line of comment.
* All long descriptions follow the same rules as the short descriptions
* All `@return` annotations should be separated from the `@param` annotations.

Example:
```php
/**
* This is the short description.
*
* This is the long description.
*
* @param string $foo
* @param int|null $bar
*
* @return string[] An array of strings
*/
```

I've also standardised the use of `@var` and `@type`. There was a mixture of these, so I went for `@var`.