Added phpdoc_seperation fixer

Replaces #845.
Nvm me, ill investigate myself to see what is really going on. It should
become clear to me then whats going on

2014-12-15 16:49 GMT+01:00 Ceeram <c33ram@gmail.com>:
>
> 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>.
>>
>