Issue #1879768 : Fixed Allow {@inheritdoc} in PHPDoc blocks.

coder_sniffer/Drupal/Sniffs/Commenting/FunctionCommentSniff.php

@@ -287,6 +287,7 @@ class Drupal_Sniffs_Commenting_FunctionCommentSniff implements PHP_CodeSniffer_S
             $phpcsFile->addError($error, ($commentStart + 1), 'ShortStartSpace');
         }
 
+        if ($testShort !== '{@inheritdoc}') {
             if (preg_match('|[A-Z]|', $testShort[0]) === 0) {
                 $error = 'Function comment short description must start with a capital letter';
                 $phpcsFile->addError($error, ($commentStart + 1), 'ShortNotCapital');
@@ -296,6 +297,7 @@ class Drupal_Sniffs_Commenting_FunctionCommentSniff implements PHP_CodeSniffer_S
                 $error = 'Function comment short description must end with a full stop';
                 $phpcsFile->addError($error, ($commentStart + 1), 'ShortFullStop');
             }
+        }
 
     }//end process()
 

coder_sniffer/Test/good.php

@@ -580,3 +580,18 @@ catch (Exception $e) {
 }
 
 $result = $x ?: FALSE;
+
+class Foo implements FooInterface {
+
+  /**
+   * {@inheritdoc}
+   */
+  public function test() {}
+
+  /**
+   * {@inheritdoc}
+   *
+   * Some additional documentation here.
+   */
+  public function test2() {}
+}