Docs: various fixes

PHPCSDebug/Sniffs/Debug/TokenListSniff.php

@@ -74,7 +74,8 @@ public function register()
      * @param int                         $stackPtr  The position of the current
      *                                               token in the stack.
      *
-     * @return void
+     * @return int|void Integer stack pointer to skip forward or void to continue
+     *                  normal file processing.
      */
     public function process(File $phpcsFile, $stackPtr)
     {

Scripts/CheckSniffCompleteness.php

@@ -31,7 +31,7 @@ class CheckSniffCompleteness
      * To disable showing progress, pass `--no-progress` on the command line
      * when calling the script.
      *
-     * @var boolean
+     * @var bool
      */
     protected $showProgress = true;
 
@@ -43,7 +43,7 @@ class CheckSniffCompleteness
      * To enable "quiet" mode, pass `-q` on the command line when calling
      * the script.
      *
-     * @var boolean
+     * @var bool
      */
     protected $quietMode = false;
 
@@ -52,7 +52,7 @@ class CheckSniffCompleteness
      *
      * This will be automatically detected if not set from the command-line.
      *
-     * @var boolean
+     * @var bool
      */
     protected $showColored;
 

Scripts/FileList.php

@@ -45,9 +45,9 @@ class FileList
     protected $rootPath;
 
     /**
-     * Recursive directory iterator.
+     * Regex iterator.
      *
-     * @var \DirectoryIterator
+     * @var \RegexIterator
      */
     protected $fileIterator;
 
@@ -85,7 +85,7 @@ public function __construct($directory, $rootPath = '', $filter = '')
     /**
      * Retrieve the filtered file list iterator.
      *
-     * @return array
+     * @return \RegexIterator
      */
     public function getIterator()
     {