phpcs-fixer: phpdoc_trim (#5052)

- see https://cs.symfony.com/doc/rules/phpdoc/phpdoc_trim.html

Author: sreichel

.php-cs-fixer.dist.php

@@ -20,6 +20,8 @@
         'phpdoc_indent' => true,
         // Orders all @param annotations in DocBlocks according to method signature.
         'phpdoc_param_order' => true,
+        // PHPDoc should start and end with content, excluding the very first and last line of the docblocks.
+        'phpdoc_trim' => true,
         // Convert double quotes to single quotes for simple strings.
         'single_quote' => true,
         // Arguments lists, array destructuring lists, arrays that are multi-line, match-lines and parameters lists must have a trailing comma.

app/Mage.php

@@ -249,7 +249,6 @@ public static function getEdition()
 
     /**
      * Set all my static data to defaults
-     *
      */
     public static function reset()
     {

app/code/core/Mage/Admin/Model/Acl.php

@@ -21,31 +21,26 @@ class Mage_Admin_Model_Acl extends Zend_Acl
 {
     /**
      * All the group roles are prepended by G
-     *
      */
     public const ROLE_TYPE_GROUP = 'G';
 
     /**
      * All the user roles are prepended by U
-     *
      */
     public const ROLE_TYPE_USER = 'U';
 
     /**
      * Permission level to deny access
-     *
      */
     public const RULE_PERM_DENY = 0;
 
     /**
      * Permission level to inheric access from parent role
-     *
      */
     public const RULE_PERM_INHERIT = 1;
 
     /**
      * Permission level to allow access
-     *
      */
     public const RULE_PERM_ALLOW = 2;
 

app/code/core/Mage/Admin/Model/Resource/Acl.php

@@ -18,7 +18,6 @@ class Mage_Admin_Model_Resource_Acl extends Mage_Core_Model_Resource_Db_Abstract
 
     /**
      * Initialize resource
-     *
      */
     protected function _construct()
     {

app/code/core/Mage/Admin/Model/Resource/Acl/Role/Collection.php

@@ -16,7 +16,6 @@ class Mage_Admin_Model_Resource_Acl_Role_Collection extends Mage_Core_Model_Reso
 {
     /**
      * Initialize resource
-     *
      */
     protected function _construct()
     {

app/code/core/Mage/Admin/Model/Resource/Block/Collection.php

@@ -16,7 +16,6 @@ class Mage_Admin_Model_Resource_Block_Collection extends Mage_Core_Model_Resourc
 {
     /**
      * Define resource model
-     *
      */
     protected function _construct()
     {

app/code/core/Mage/Admin/Model/Resource/Permissions/Collection.php

@@ -16,7 +16,6 @@ class Mage_Admin_Model_Resource_Permissions_Collection extends Mage_Core_Model_R
 {
     /**
      * Initialize resource
-     *
      */
     protected function _construct()
     {

app/code/core/Mage/Admin/Model/Resource/User/Collection.php

@@ -16,7 +16,6 @@ class Mage_Admin_Model_Resource_User_Collection extends Mage_Core_Model_Resource
 {
     /**
      * Define resource model
-     *
      */
     protected function _construct()
     {

app/code/core/Mage/Admin/Model/Resource/Variable/Collection.php

@@ -19,7 +19,6 @@ class Mage_Admin_Model_Resource_Variable_Collection extends Mage_Core_Model_Reso
 {
     /**
      * Define resource model
-     *
      */
     protected function _construct()
     {

app/code/core/Mage/AdminNotification/Model/Feed.php

@@ -31,7 +31,6 @@ class Mage_AdminNotification_Model_Feed extends Mage_Core_Model_Abstract
 
     /**
      * Init model
-     *
      */
     protected function _construct() {}