Added phpdoc_seperation fixer

Replaces #845.
I wonder why that happens, the params aligment and separattion of the tags
itself should not matter which one is handled first

2014-12-15 16:17 GMT+01:00 Graham Campbell <notifications@github.com>:
>
> In Symfony/CS/Fixer/Symfony/PhpdocSeparationFixer.php
> <https://github.com/FriendsOfPHP/PHP-CS-Fixer/pull/853#discussion-diff-21830847>
> :
>
> > +    }
> > +
> > +    /**
> > +     * {@inheritdoc}
> > +     */
> > +    public function getDescription()
> > +    {
> > +        return 'Annotations in phpdocs should be separated correctly.';
> > +    }
> > +
> > +    /**
> > +     * {@inheritdoc}
> > +     */
> > +    public function getPriority()
> > +    {
> > +        // should be run before the PhpdocParamsFixer
>
> It makes a massive difference!
>
> *Example if we run them the wrong order:*
>
> Before:
>
>     /**     * @param string $foo     * @return bool     */
>
> after:
>
>     /**     * @param  string $foo     *     * @return bool     */
>
> Note how the param is now not aligned correctly.
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/FriendsOfPHP/PHP-CS-Fixer/pull/853/files#r21830847>.
>