DisallowSpaceIndent: Allow the sniff to fix space indents for multi-line /* */ comments

Code sample:
```php
    /*
     * Some text
     */
```

The tokenizer tokenizes this code as:
```
T_WHITESPACE T_COMMENT
T_COMMENT
T_COMMENT
```

In other words, the whitespace at the start of subsequent comment lines is tokenized as part of the `T_COMMENT`.

In effect, this meant that these lines would not throw the appropriate error, nor be fixed by this sniff.

This commit fixes that.

Includes unit tests.

Author: jrfnl

src/Standards/Generic/Sniffs/WhiteSpace/DisallowSpaceIndentSniff.php

@@ -72,6 +72,7 @@ public function process(File $phpcsFile, $stackPtr)
                         T_WHITESPACE             => true,
                         T_INLINE_HTML            => true,
                         T_DOC_COMMENT_WHITESPACE => true,
+                        T_COMMENT                => true,
                        );
 
         $tokens = $phpcsFile->getTokens();
@@ -88,10 +89,13 @@ public function process(File $phpcsFile, $stackPtr)
                 $content = $tokens[$i]['content'];
             }
 
-            // If this is an inline HTML token, split the content into
-            // indentation whitespace and the actual HTML/text.
+            // If this is an inline HTML token or a subsequent line of a multi-line comment,
+            // split the content into indentation whitespace and the actual HTML/text.
             $nonWhitespace = '';
-            if ($tokens[$i]['code'] === T_INLINE_HTML && preg_match('`^(\s*)(\S.*)`s', $content, $matches) > 0) {
+            if (($tokens[$i]['code'] === T_INLINE_HTML
+                || $tokens[$i]['code'] === T_COMMENT)
+                && preg_match('`^(\s*)(\S.*)`s', $content, $matches) > 0
+            ) {
                 if (isset($matches[1]) === true) {
                     $content = $matches[1];
                 }
@@ -115,8 +119,11 @@ public function process(File $phpcsFile, $stackPtr)
                 continue;
             }
 
-            if ($tokens[$i]['code'] === T_DOC_COMMENT_WHITESPACE && $content === ' ') {
-                // Ignore file/class-level DocBlock, especially for recording metrics.
+            if (($tokens[$i]['code'] === T_DOC_COMMENT_WHITESPACE
+                || $tokens[$i]['code'] === T_COMMENT)
+                && $content === ' '
+            ) {
+                // Ignore all non-indented comments, especially for recording metrics.
                 continue;
             }