bestit / PHP_CodeSniffer

        }

        // No extra newline before short description.

        if ($tokens[$short]['line'] !== ($tokens[$stackPtr]['line'] + 1)) {

            $error = 'Doc comment short description must be on the first line';

            $fix   = $phpcsFile->addFixableError($error, $short, self::CODE_SPACING_BEFORE_SHORT);

            if ($fix === true) {

                $phpcsFile->fixer->beginChangeset();

                for ($i = $stackPtr; $i < $short; $i++) {

                    if ($tokens[$i]['line'] === $tokens[$stackPtr]['line']) {

                        continue;

                    } elseif ($tokens[$i]['line'] === $tokens[$short]['line']) {

                        break;

                    }

                    $phpcsFile->fixer->replaceToken($i, '');

                }

                $phpcsFile->fixer->endChangeset();

            }

        }

        // Account for the fact that a short description might cover

        // multiple lines.

        $long = $phpcsFile->findNext($empty, $shortEnd + 1, $commentEnd - 1, true);

        if ($long !== false && $tokens[$long]['code'] === T_DOC_COMMENT_STRING) {

            if ($tokens[$long]['line'] !== ($tokens[$shortEnd]['line'] + 2)) {

                $error = 'There must be exactly one blank line between descriptions in a doc comment';

                $fix   = $phpcsFile->addFixableError($error, $long, self::CODE_SPACING_BETWEEN);

                if ($fix === true) {

                    $phpcsFile->fixer->beginChangeset();

                    for ($i = ($shortEnd + 1); $i < $long; $i++) {

                        if ($tokens[$i]['line'] === $tokens[$shortEnd]['line']) {

                            continue;

                        } elseif ($tokens[$i]['line'] === ($tokens[$long]['line'] - 1)) {

                            break;

                        }

                        $phpcsFile->fixer->replaceToken($i, '');

                    }

                    $phpcsFile->fixer->endChangeset();

                }

            }

            if (preg_match('/^\p{Ll}/u', $tokens[$long]['content']) === 1) {

                $error = 'Doc comment long description must start with a capital letter';