Added phpdoc_seperation fixer

Replaces #845.
Yes, but that would mean someone having tags separated correctly already
but not inlined correctly also doesnt get things fixed?

2014-12-15 16:42 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-21833032>
> :
>
> > +    }
> > +
> > +    /**
> > +     * {@inheritdoc}
> > +     */
> > +    public function getDescription()
> > +    {
> > +        return 'Annotations in phpdocs should be separated correctly.';
> > +    }
> > +
> > +    /**
> > +     * {@inheritdoc}
> > +     */
> > +    public function getPriority()
> > +    {
> > +        // should be run before the PhpdocParamsFixer
>
> Ok, it happens because we're not aligning each annotation grouped with
> their type, we're aligning all annotations together.
> ------------------------------
>
> just with the align fixer:
>
> before:
>
>     /*     * @param Foo $foo     * @return bool
>
> after
>
>     /*     * @param  Foo $foo     * @return bool
>
> ------------------------------
>
> another example with just that fixer enabled:
>
>     /*     * @param Foo $foo     *     * @return bool
>
> now that code won't be changed
> ------------------------------
>
> Do you see why we need that order now?
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/FriendsOfPHP/PHP-CS-Fixer/pull/853/files#r21833032>.
>