Issue #2572643 by alexpott, attiks, Jelle_S, jhodgdon: Fix...

Issue #2572643 by alexpott, attiks, Jelle_S, jhodgdon: Fix Drupal.Commenting.FileComment coding standard

core/includes/install.core.inc

 <?php
 
+/**
+ * @file
+ * API functions for installing Drupal.
+ */
+
 use Drupal\Component\Utility\UrlHelper;
 use Drupal\Core\DrupalKernel;
 use Drupal\Core\Config\BootstrapConfigStorageFactory;
@@ -28,11 +33,6 @@
 use Drupal\user\Entity\User;
 use GuzzleHttp\Exception\RequestException;
 
-/**
- * @file
- * API functions for installing Drupal.
- */
-
 /**
  * Do not run the task during the current installation request.
  *

core/includes/tablesort.inc

 <?php
 
-use Drupal\Component\Utility\SafeMarkup;
-use Drupal\Core\Url;
-use Drupal\Component\Utility\UrlHelper;
-
 /**
  * @file
  * Functions to aid in the creation of sortable tables.
@@ -13,6 +9,10 @@
  * column.
  */
 
+use Drupal\Component\Utility\SafeMarkup;
+use Drupal\Core\Url;
+use Drupal\Component\Utility\UrlHelper;
+
 /**
  * Initializes the table sort context.
  */

core/lib/Drupal/Component/Bridge/ZfExtensionManagerSfContainer.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Component\Bridge\ZfExtensionManagerSfContainer.
  */
+
 namespace Drupal\Component\Bridge;
 
 use Symfony\Component\DependencyInjection\ContainerAwareInterface;

core/lib/Drupal/Component/Datetime/DateTimePlus.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Component\Datetime\DateTimePlus.
  */
+
 namespace Drupal\Component\Datetime;
 use Drupal\Component\Utility\ToStringTrait;
 

core/lib/Drupal/Component/PhpStorage/MTimeProtectedFileStorage.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Component\PhpStorage\MTimeProtectedFileStorage.
  */
+
 namespace Drupal\Component\PhpStorage;
 
 /**

core/lib/Drupal/Component/Utility/Number.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Component\Utility\Number.
  */
+
 namespace Drupal\Component\Utility;
 
 /**

core/lib/Drupal/Core/Archiver/ArchiveTar.php

 <?php
+// @codingStandardsIgnoreFile
 /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
 
 /**

core/lib/Drupal/Core/Config/Entity/ConfigDependencyDeleteFormTrait.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\Core\Config\Entity\ConfigDependencyDeleteFormTrait.
  */
 
-
 namespace Drupal\Core\Config\Entity;
 
 use Drupal\Core\Config\ConfigManagerInterface;

core/lib/Drupal/Core/Controller/TitleResolverInterface.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Core\Controller\TitleResolverInterface.
  */
+
 namespace Drupal\Core\Controller;
 
 use Symfony\Component\Routing\Route;

core/lib/Drupal/Core/Datetime/DateHelper.php

@@ -14,6 +14,7 @@
  * translation should be hard-coded and wrapped in t() so the translation system
  * will be able to process them.
  */
+
 namespace Drupal\Core\Datetime;
 
 /**

core/lib/Drupal/Core/Datetime/DrupalDateTime.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Core\Datetime\DrupalDateTime.
  */
+
 namespace Drupal\Core\Datetime;
 
 use Drupal\Component\Datetime\DateTimePlus;

core/lib/Drupal/Core/DependencyInjection/Compiler/RegisterLazyRouteEnhancers.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\Core\DependencyInjection\Compiler\RegisterLazyRouteEnhancers.
  */
 
-
 namespace Drupal\Core\DependencyInjection\Compiler;
 
 use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;

core/lib/Drupal/Core/DependencyInjection/Compiler/RegisterLazyRouteFilters.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\Core\DependencyInjection\Compiler\RegisterLazyRouteFilters.
  */
 
-
 namespace Drupal\Core\DependencyInjection\Compiler;
 
 use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;

core/lib/Drupal/Core/Entity/Query/Sql/pgsql/QueryFactory.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\Core\Entity\Query\Sql\pgsql\QueryFactory.
  */
 
-
 namespace Drupal\Core\Entity\Query\Sql\pgsql;
 
 use Drupal\Core\Entity\Query\Sql\QueryFactory as BaseQueryFactory;

core/lib/Drupal/Core/Menu/LocalActionManagerInterface.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Core\Menu\LocalActionManagerInterface.
  */
+
 namespace Drupal\Core\Menu;
 
 use Drupal\Component\Plugin\PluginManagerInterface;

core/lib/Drupal/Core/Menu/LocalTaskManagerInterface.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Core\Menu\LocalTaskManagerInterface.
  */
+
 namespace Drupal\Core\Menu;
 
 use Drupal\Component\Plugin\PluginManagerInterface;

core/modules/block_content/src/Tests/Views/RevisionRelationshipsTest.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\block_content\Tests\Views\RevisionRelationshipsTest.
  */
+
 namespace Drupal\block_content\Tests\Views;
 
 use Drupal\block_content\Entity\BlockContentType;

core/modules/comment/comment.api.php

 <?php
 
-use Drupal\comment\CommentInterface;
-use Drupal\Core\Url;
-
 /**
  * @file
  * Hooks provided by the Comment module.
  */
 
+use Drupal\comment\CommentInterface;
+use Drupal\Core\Url;
+
 /**
  * @addtogroup hooks
  * @{

core/modules/field/field.api.php

 <?php
 
+/**
+ * @file
+ * Field API documentation.
+ */
+
 /**
  * @addtogroup hooks
  * @{

core/modules/field/tests/modules/field_test/field_test.module

 <?php
 
-use Drupal\field\FieldStorageConfigInterface;
-use Drupal\Core\Form\FormStateInterface;
-use Drupal\field\Entity\FieldStorageConfig;
-
 /**
  * @file
  * Helper module for the Field API tests.
@@ -17,6 +13,10 @@
  * test helper functions
  */
 
+use Drupal\field\FieldStorageConfigInterface;
+use Drupal\Core\Form\FormStateInterface;
+use Drupal\field\Entity\FieldStorageConfig;
+
 require_once __DIR__ . '/field_test.entity.inc';
 require_once __DIR__ . '/field_test.field.inc';
 

core/modules/field/tests/modules/field_test/src/Plugin/Field/FieldFormatter/TestFieldEmptyFormatter.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\field_test\Plugin\Field\FieldFormatter\TestFieldEmptyFormatter.
  */
+
 namespace Drupal\field_test\Plugin\Field\FieldFormatter;
 
 use Drupal\Core\Field\FieldItemListInterface;

core/modules/field/tests/modules/field_test/src/Plugin/Field/FieldFormatter/TestFieldNoSettingsFormatter.php

@@ -5,6 +5,7 @@
  *
  * Contains \Drupal\field_test\Plugin\Field\FieldFormatter\TestFieldNoSettingsFormatter.
  */
+
 namespace Drupal\field_test\Plugin\Field\FieldFormatter;
 
 use Drupal\Core\Field\FieldItemListInterface;

core/modules/field/tests/modules/field_third_party_test/field_third_party_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 use Drupal\Core\Form\FormStateInterface;
 
 /**

core/modules/filter/src/Plugin/migrate/process/d6/FilterFormatPermission.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\filter\Plugin\migrate\process\d6\FilterFormatPermission.
  */
 
-
 namespace Drupal\filter\Plugin\migrate\process\d6;
 
 use Drupal\Core\Plugin\ContainerFactoryPluginInterface;

core/modules/forum/src/ForumIndexStorageInterface.php

@@ -3,6 +3,7 @@
  * @file
  * Contains \Drupal\forum\ForumIndexStorageInterface.
  */
+
 namespace Drupal\forum;
 
 use Drupal\node\NodeInterface;

core/modules/language/src/Tests/LanguageConfigOverrideInstallTest.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\language\Tests\LanguageConfigOverrideInstallTest.
  */
+
 namespace Drupal\language\Tests;
 
 use Drupal\language\Entity\ConfigurableLanguage;

core/modules/menu_link_content/tests/src/Unit/Plugin/migrate/source/MenuLinkSourceTest.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\Tests\menu_link_content\Unit\Plugin\migrate\source\MenuLinkSourceTest.
  */
+
 namespace Drupal\Tests\menu_link_content\Unit\Plugin\migrate\source;
 
 use Drupal\Component\Utility\Unicode;

core/modules/migrate/src/Plugin/migrate/process/MenuLinkParent.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\migrate\Plugin\migrate\process\MenuLinkContent.
  */
 
-
 namespace Drupal\migrate\Plugin\migrate\process;
 
 use Drupal\Core\Entity\EntityStorageInterface;

core/modules/migrate/tests/src/Unit/process/SkipOnEmptyTest.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\Tests\migrate\Unit\process\SkipOnEmptyTest.
  */
 
-
 namespace Drupal\Tests\migrate\Unit\process;
 use Drupal\migrate\Plugin\migrate\process\SkipOnEmpty;
 

core/modules/node/node.api.php

 <?php
 
-use Drupal\node\NodeInterface;
-use Drupal\Component\Utility\Html;
-use Drupal\Component\Utility\Xss;
-use Drupal\Core\Access\AccessResult;
-
 /**
  * @file
  * Hooks specific to the Node module.
  */
 
+use Drupal\node\NodeInterface;
+use Drupal\Component\Utility\Html;
+use Drupal\Component\Utility\Xss;
+use Drupal\Core\Access\AccessResult;
+
 /**
  * @addtogroup hooks
  * @{

core/modules/node/src/Tests/Views/RevisionRelationshipsTest.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\node\Tests\Views\RevisionRelationshipsTest.
  */
+
 namespace Drupal\node\Tests\Views;
 
 use Drupal\views\Views;

core/modules/options/src/Tests/OptionsFieldUnitTestBase.php

@@ -5,7 +5,6 @@
  * Contains \Drupal\options\Tests\OptionsFieldUnitTestBase.
  */
 
-
 namespace Drupal\options\Tests;
 
 use Drupal\field\Tests\FieldUnitTestBase;

core/modules/search/tests/modules/search_query_alter/search_query_alter.module

 <?php
 
-use Drupal\Core\Database\Query\AlterableInterface;
-
 /**
  * @file
  * Test module that alters search queries.
  */
 
+use Drupal\Core\Database\Query\AlterableInterface;
+
 /**
  * Implements hook_query_TAG_alter(): tag search_$type with $type node_search.
  */

core/modules/simpletest/files/php-1.txt

 <?php
+// @codingStandardsIgnoreFile
 print 'SimpleTest PHP was executed!';
 ?>

core/modules/simpletest/files/php-2.php

 <?php
+// @codingStandardsIgnoreFile
 print 'SimpleTest PHP was executed!';

core/modules/simpletest/simpletest.module

 <?php
 
+/**
+ * @file
+ * Provides testing functionality.
+ */
+
 use Drupal\Core\Asset\AttachedAssetsInterface;
 use Drupal\Core\Database\Database;
 use Drupal\Core\Render\Element;
@@ -8,11 +13,6 @@
 use Drupal\simpletest\TestDiscovery;
 use Symfony\Component\Process\PhpExecutableFinder;
 
-/**
- * @file
- * Provides testing functionality.
- */
-
 /**
  * Implements hook_help().
  */

core/modules/simpletest/tests/fixtures/simpletest_phpunit_run_command_test.php

 <?php
 
+/**
+ * @file
+ * Contains \Drupal\Tests\simpletest\Unit\SimpletestPhpunitRunCommandTestWillDie.
+ */
+
 namespace Drupal\Tests\simpletest\Unit;
 
 use Drupal\Tests\UnitTestCase;

core/modules/simpletest/tests/modules/simpletest_test/simpletest_test.install

 <?php
 
+/**
+ * @file
+ * Install hooks for test module.
+ */
+
 /**
  * Implements hook_install().
  */

core/modules/system/src/Tests/Entity/EntityQueryAggregateTest.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\system\Tests\Entity\EntityQueryAggregateTest.
  */
+
 namespace Drupal\system\Tests\Entity;
 
 use Drupal\field\Entity\FieldStorageConfig;

core/modules/system/tests/fixtures/update/drupal-8.broken_routing.php

 <?php
 
+/**
+ * @file
+ * Test fixture.
+ */
+
 use Drupal\Core\Database\Database;
 
 

core/modules/system/tests/fixtures/update/drupal-8.without_automated_cron.php

 <?php
 
+/**
+ * @file
+ * Test fixture.
+ */
+
 $connection = Drupal\Core\Database\Database::getConnection();
 $config = $connection;
 

core/modules/system/tests/modules/database_test/database_test.module

 <?php
 
+/**
+ * @file
+ * Database test module.
+ */
+
 use Drupal\Core\Database\Query\AlterableInterface;
 
 /**

core/modules/system/tests/modules/entity_test/entity_test.views.inc

 <?php
 
+/**
+ * @file
+ * Include file for test module.
+ */
+
 /**
  * Implements hook_views_data_alter().
  */

core/modules/system/tests/modules/module_required_test/module_required_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 use Drupal\Core\Extension\Extension;
 
 /**

core/modules/system/tests/modules/module_test/module_test.implementations.inc

 <?php
 
+/**
+ * @file
+ * Include file for test module.
+ */
+
 /**
  * Implements hook_altered_test_hook().
  *

core/modules/system/tests/modules/module_test/module_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 use Drupal\Core\Extension\Extension;
 
 /**

core/modules/system/tests/modules/module_test/module_test.post_update.php

 <?php
 
+/**
+ * @file
+ * Post update functions for test module.
+ */
+
 /**
  * Test post update function.
  */

core/modules/system/tests/modules/requirements1_test/requirements1_test.install

 <?php
 
+/**
+ * @file
+ * Install hooks for test module.
+ */
+
 /**
  * Implements hook_requirements().
  */

core/modules/system/tests/modules/session_test/session_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 /**
  * Implements hook_user_login().
  */

core/modules/system/tests/modules/system_test/system_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 use Drupal\Core\Extension\Extension;
 use Drupal\Core\Routing\RouteMatchInterface;
 

core/modules/system/tests/modules/theme_page_test/theme_page_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 use Drupal\Core\Extension\Extension;
 
 /**

core/modules/system/tests/modules/theme_test/theme_test.inc

 <?php
 
+/**
+ * @file
+ * Include file for test module.
+ */
+
 /**
  * Returns HTML for the 'theme_test' theme hook used by tests.
  */

core/modules/system/tests/modules/theme_test/theme_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 use Drupal\Core\Extension\Extension;
 
 /**

core/modules/system/tests/modules/twig_theme_test/twig_theme_test.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 /**
  * Implements hook_theme().
  */

core/modules/system/tests/modules/update_test_failing/update_test_failing.post_update.php

 <?php
 
+/**
+ * @file
+ * Post update functions for test module.
+ */
+
 /**
  * First update, should not be run since this module's update hooks fail.
  */

core/modules/system/tests/modules/update_test_postupdate/update_test_postupdate.install

 <?php
 
+/**
+ * @file
+ * Install hooks for test module.
+ */
+
 /**
  * Normal update_N() function.
  */

core/modules/system/tests/modules/update_test_postupdate/update_test_postupdate.post_update.php

 <?php
 
+/**
+ * @file
+ * Post update functions for test module.
+ */
+
 /**
  * First update.
  */

core/modules/system/tests/modules/url_alter_test/url_alter_test.install

 <?php
 
+/**
+ * @file
+ * Install hooks for test module.
+ */
+
 /**
  * Implements hook_install().
  */

core/modules/system/tests/themes/test_basetheme/test_basetheme.theme

@@ -4,6 +4,7 @@
  * @file
  * Add hooks for tests to use.
  */
+
 use Drupal\views\Plugin\views\cache\CachePluginBase;
 use Drupal\views\ViewExecutable;
 

core/modules/system/tests/themes/test_theme_nyan_cat_engine/test_theme_nyan_cat_engine.theme

 <?php
 
+/**
+ * @file
+ * Test theme.
+ */
+
 /**
  * Implements hook_preprocess_theme_test_template_test().
  */

core/modules/taxonomy/src/Tests/VocabularyTranslationTest.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\taxonomy\Tests\VocabularyTranslationTest.
  */
+
 namespace Drupal\taxonomy\Tests;
 
 use Drupal\Component\Utility\Unicode;

core/modules/text/src/Plugin/Field/FieldFormatter/TextTrimmedFormatter.php

@@ -4,6 +4,7 @@
  * @file
  * Contains \Drupal\text\Plugin\Field\FieldFormatter\TextTrimmedFormatter.
  */
+
 namespace Drupal\text\Plugin\Field\FieldFormatter;
 
 use Drupal\Core\Field\FormatterBase;

core/modules/toolbar/tests/modules/toolbar_disable_user_toolbar/toolbar_disable_user_toolbar.module

 <?php
 
+/**
+ * @file
+ * Test module.
+ */
+
 /**