Squiz/DocCommentAlignment: add support for final classes and final properties

If a class or property used the `final` keyword, the docblock would not be recognized as one which needed examining.

Fixed now.

Includes tests.

Author: jrfnl

src/Standards/Squiz/Sniffs/Commenting/DocCommentAlignmentSniff.php

@@ -55,6 +55,7 @@ public function process(File $phpcsFile, $stackPtr)
             T_PROTECTED => true,
             T_STATIC    => true,
             T_ABSTRACT  => true,
+            T_FINAL     => true,
             T_PROPERTY  => true,
             T_OBJECT    => true,
             T_PROTOTYPE => true,

src/Standards/Squiz/Tests/Commenting/DocCommentAlignmentUnitTest.inc

@@ -101,3 +101,16 @@ enum Suits: string
  * Example with no errors.
  **************************************************************************/
 function example() {}
+
+/**
+  *  Some info about the class here.
+    */
+final class FinalClassWithFinalProp
+{
+    /**
+   *Some info about the property here.
+    *
+     *  @var int
+      */
+    final $property = 10;
+}

src/Standards/Squiz/Tests/Commenting/DocCommentAlignmentUnitTest.inc.fixed

@@ -101,3 +101,16 @@ enum Suits: string
  * Example with no errors.
  **************************************************************************/
 function example() {}
+
+/**
+ *  Some info about the class here.
+ */
+final class FinalClassWithFinalProp
+{
+    /**
+     * Some info about the property here.
+     *
+     * @var int
+     */
+    final $property = 10;
+}

src/Standards/Squiz/Tests/Commenting/DocCommentAlignmentUnitTest.php

@@ -31,26 +31,32 @@ final class DocCommentAlignmentUnitTest extends AbstractSniffUnitTest
     public function getErrorList()
     {
         return [
-            3  => 1,
-            11 => 1,
-            17 => 1,
-            18 => 1,
-            19 => 1,
-            23 => 2,
-            24 => 1,
-            25 => 2,
-            26 => 1,
-            32 => 1,
-            33 => 1,
-            38 => 1,
-            39 => 1,
-            75 => 1,
-            83 => 1,
-            84 => 1,
-            90 => 1,
-            91 => 1,
-            95 => 1,
-            96 => 1,
+            3   => 1,
+            11  => 1,
+            17  => 1,
+            18  => 1,
+            19  => 1,
+            23  => 2,
+            24  => 1,
+            25  => 2,
+            26  => 1,
+            32  => 1,
+            33  => 1,
+            38  => 1,
+            39  => 1,
+            75  => 1,
+            83  => 1,
+            84  => 1,
+            90  => 1,
+            91  => 1,
+            95  => 1,
+            96  => 1,
+            106 => 1,
+            107 => 1,
+            111 => 2,
+            112 => 1,
+            113 => 1,
+            114 => 1,
         ];
 
     }//end getErrorList()