feat: Add statement_indentation config not_for_comments

[rudiedirkx]

New option to completely ignore // commented lines. I like my temporary comments to be very explicit, not neatly indented with the rest of the code. Real comments, I'll correctly indent myself, these temp comments, I'll put at the start of the line, or maybe more indented than the rest, whatever stands out.

E.g., while playing with phpstan:

 public function buildForm(): void {
 // \PHPStan\dumpType($this->model); // << Leave this one alone
-$this->platform = $this->requireData('platform'); // << Indent this one 1 level
+	$this->platform = $this->requireData('platform'); // << Indent this one 1 level
 	$this->required = $this->requireData('required');
 
 	$this->platform->buildKeyForm($this, $this->required);
}

[coveralls]

coverage: 96.032% (+0.002%) from 96.03%
when pulling 081423b on rudiedirkx:statement_indentation-not_for_comments
into 37d8d45 on PHP-CS-Fixer:master.

[mvorisek]

I would prefer option to "allow_zero_indented_comments" to keep comments with zero indentation, but align every other comments with non-zero indentation.

[rudiedirkx]

I agree. And that's also how I use it, but not how I made it. I'll give that a shot. I'm not sure I understand the $tokens magic well enough (white-space tokens seem to cross EOL..?), but I'll give it a go.

[mvorisek]

Suggested change

	``not_for_comments``
	``skip_single_line_comments``

[rudiedirkx]

I like allow_zero_indented_comments better, because that's what it does. I have the occasional two lines of // \PHPStan\dumpType() at line start.

[mvorisek]

I like it. Make sure it is only for single line comments starting with //.

[julienfalque]

This looks like a very specific edge case, I'm not sure we want to support it natively. Is this part of some widespread code style?

[rudiedirkx]

No widespread code style as far as I know.