Add docblock indent fixer

Ensure that docblocks for class methods and attributes are indented if present
EDIT: Ensure that any docblock uses the same indentation as the documented subject, regardless the type
Because the indentation before docblock is part of the previous whitespace
token
Op 7 dec. 2014 19:23 schreef "Dariusz Rumiński" <notifications@github.com>:

> In Symfony/CS/Fixer/Contrib/PhpdocIndentFixer.php:
>
> > +    {
> > +        $tokens = Tokens::fromCode($content);
> > +
> > +        foreach ($tokens->findGivenKind(T_DOC_COMMENT) as $index => $token) {
> > +            $next = $tokens->getNextMeaningfulToken($index);
> > +            if ($next === null) {
> > +                continue;
> > +            }
> > +
> > +            $indent = $this->calculateIndent($tokens[$next - 1]->getContent());
> > +
> > +            $prevToken = $tokens[$index - 1];
> > +
> > +            $prevToken->setContent($this->fixWhitespaceBefore($prevToken->getContent(), $indent));
> > +
> > +            $token->setContent($this->fixDocBlock($token->getContent(), $indent));
>
> why you also need to change $prevToken content?
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/FriendsOfPHP/PHP-CS-Fixer/pull/790/files#r21426719>.
>