[WIP] Added phpdoc_separation fixer

The idea here is to go from:

```php
    /**
     * @param EngineInterface $templating
     * @return void
     */
```

to 

```php
    /**
     * @param EngineInterface $templating
     *
     * @return void
     */
```
That was my original argument as well for phpdoc_indent, but it was
required to introduce more of those newline replacements. It should be
removed from other fixers as well.
Op 10 dec. 2014 13:24 schreef "Graham Campbell" <notifications@github.com>:

> In Symfony/CS/Fixer/Symfony/PhpdocSeparationFixer.php
> <https://github.com/FriendsOfPHP/PHP-CS-Fixer/pull/812#discussion-diff-21599883>
> :
>
> > +        foreach ($tokens as $index => $token) {
> > +            if (!$token->isGivenKind(T_DOC_COMMENT)) {
> > +                continue;
> > +            }
> > +
> > +            $tokens[$index]->setContent($this->fixDocBlock($token->getContent()));
> > +        }
> > +
> > +        return $tokens->generateCode();
> > +    }
> > +
> > +    private function fixDocBlock($content)
> > +    {
> > +        $lines = explode("\n", str_replace(array("\r\n", "\r"), "\n", $content));
> > +
> > +        // make sure annotations are pushed up against the side of the docblock
>
>  Also same explode() implode() on newlines is done here that changes
> newlines
>
> That's not a problem. The phpdoc_params fixer does the same thing.
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/FriendsOfPHP/PHP-CS-Fixer/pull/812/files#r21599883>.
>