Issue #3183673 by jonathan1055, longwave: Fix...

Issue #3183673 by jonathan1055, longwave: Fix 'Drupal.Commenting.DocComment.ShortFullStop' coding standard - part 1 auto-fixes

core/lib/Drupal/Component/Plugin/Discovery/StaticDiscoveryDecorator.php

@@ -58,7 +58,7 @@ public function getDefinitions() {
   }
 
   /**
-   * Passes through all unknown calls onto the decorated object
+   * Passes through all unknown calls onto the decorated object.
    */
   public function __call($method, $args) {
     return call_user_func_array([$this->decorated, $method], $args);

core/lib/Drupal/Core/Action/Plugin/Action/EmailAction.php

@@ -49,7 +49,7 @@ class EmailAction extends ConfigurableActionBase implements ContainerFactoryPlug
   protected $logger;
 
   /**
-   * The mail manager
+   * The mail manager.
    *
    * @var \Drupal\Core\Mail\MailManagerInterface
    */

core/lib/Drupal/Core/Cache/Context/CacheContextsManager.php

@@ -294,7 +294,7 @@ public function validateTokens(array $context_tokens = []) {
   }
 
   /**
-   * Asserts the context tokens are valid
+   * Asserts the context tokens are valid.
    *
    * Similar to ::validateTokens, this method returns boolean TRUE when the
    * context tokens are valid, and FALSE when they are not instead of returning

core/lib/Drupal/Core/Database/Connection.php

@@ -1741,7 +1741,7 @@ public function commit() {
   abstract public function nextId($existing_id = 0);
 
   /**
-   * Prepares a statement for execution and returns a statement object
+   * Prepares a statement for execution and returns a statement object.
    *
    * Emulated prepared statements do not communicate with the database server so
    * this method does not check the statement.

core/lib/Drupal/Core/Database/Driver/sqlite/Schema.php

@@ -17,7 +17,7 @@
 class Schema extends DatabaseSchema {
 
   /**
-   * Override DatabaseSchema::$defaultSchema
+   * Override DatabaseSchema::$defaultSchema.
    *
    * @var string
    */

core/lib/Drupal/Core/Database/Query/Select.php

@@ -79,7 +79,7 @@ class Select extends Query implements SelectInterface {
   protected $having;
 
   /**
-   * Whether or not this query should be DISTINCT
+   * Whether or not this query should be DISTINCT.
    *
    * @var bool
    */
@@ -112,7 +112,7 @@ class Select extends Query implements SelectInterface {
   protected $prepared = FALSE;
 
   /**
-   * The FOR UPDATE status
+   * The FOR UPDATE status.
    *
    * @var bool
    */

core/lib/Drupal/Core/Database/StatementInterface.php

@@ -40,7 +40,7 @@ interface StatementInterface extends \Traversable {
   // protected function __construct(Connection $dbh);
 
   /**
-   * Executes a prepared statement
+   * Executes a prepared statement.
    *
    * @param $args
    *   An array of values with as many elements as there are bound parameters in

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

@@ -100,7 +100,7 @@ public static function monthNames($required = FALSE) {
   }
 
   /**
-   * Constructs a translated array of month name abbreviations
+   * Constructs a translated array of month name abbreviations.
    *
    * @param bool $required
    *   (optional) If FALSE, the returned array will include a blank value.

core/lib/Drupal/Core/DrupalKernel.php

@@ -1351,7 +1351,7 @@ protected function cacheDrupalContainer(array $container_definition) {
   }
 
   /**
-   * Gets a http kernel from the container
+   * Gets a http kernel from the container.
    *
    * @return \Symfony\Component\HttpKernel\HttpKernelInterface
    */

core/lib/Drupal/Core/Entity/EntityForm.php

@@ -304,7 +304,7 @@ public function buildEntity(array $form, FormStateInterface $form_state) {
   }
 
   /**
-   * Copies top-level form values to entity properties
+   * Copies top-level form values to entity properties.
    *
    * This should not change existing entity properties that are not being edited
    * by this form.

core/lib/Drupal/Core/Entity/Query/QueryBase.php

@@ -61,7 +61,7 @@ abstract class QueryBase implements QueryInterface {
   protected $groupBy = [];
 
   /**
-   * Aggregate Conditions
+   * Aggregate Conditions.
    *
    * @var \Drupal\Core\Entity\Query\ConditionAggregateInterface
    */

core/lib/Drupal/Core/Field/FieldTypePluginManager.php

@@ -27,7 +27,7 @@ class FieldTypePluginManager extends DefaultPluginManager implements FieldTypePl
   protected $typedDataManager;
 
   /**
-   * Constructs the FieldTypePluginManager object
+   * Constructs the FieldTypePluginManager object.
    *
    * @param \Traversable $namespaces
    *   An object that implements \Traversable which contains the root paths

core/lib/Drupal/Core/FileTransfer/ChmodInterface.php

@@ -8,7 +8,7 @@
 interface ChmodInterface {
 
   /**
-   * Changes the permissions of the file / directory specified in $path
+   * Changes the permissions of the file / directory specified in $path.
    *
    * @param string $path
    *   Path to change permissions of.

core/lib/Drupal/Core/Flood/DatabaseBackend.php

@@ -67,7 +67,7 @@ public function register($name, $window = 3600, $identifier = NULL) {
   }
 
   /**
-   * Inserts an event into the flood table
+   * Inserts an event into the flood table.
    *
    * @param string $name
    *   The name of an event.

core/lib/Drupal/Core/Logger/LoggerChannel.php

@@ -79,7 +79,7 @@ class LoggerChannel implements LoggerChannelInterface {
   protected $currentUser;
 
   /**
-   * Constructs a LoggerChannel object
+   * Constructs a LoggerChannel object.
    *
    * @param string $channel
    *   The channel name for this instance.

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

@@ -31,7 +31,7 @@ class MenuParentFormSelector implements MenuParentFormSelectorInterface {
   protected $entityTypeManager;
 
   /**
-   * Constructs a \Drupal\Core\Menu\MenuParentFormSelector
+   * Constructs a \Drupal\Core\Menu\MenuParentFormSelector.
    *
    * @param \Drupal\Core\Menu\MenuLinkTreeInterface $menu_link_tree
    *   The menu link tree service.

core/lib/Drupal/Core/PhpStorage/PhpStorageFactory.php

@@ -6,7 +6,7 @@
 use Drupal\Core\StreamWrapper\PublicStream;
 
 /**
- * Creates a php storage object
+ * Creates a php storage object.
  */
 class PhpStorageFactory {
 

core/lib/Drupal/Core/Render/Element/Email.php

@@ -29,7 +29,7 @@
 class Email extends FormElement {
 
   /**
-   * Defines the max length for an email address
+   * Defines the max length for an email address.
    *
    * The maximum length of an email address is 254 characters. RFC 3696
    * specifies a total length of 320 characters, but mentions that

core/lib/Drupal/Core/Routing/RouteProviderInterface.php

@@ -6,7 +6,7 @@
 use Symfony\Cmf\Component\Routing\RouteProviderInterface as RouteProviderBaseInterface;
 
 /**
- * Extends the router provider interface
+ * Extends the router provider interface.
  *
  * @see \Symfony\Cmf\Component\Routing
  */

core/lib/Drupal/Core/StringTranslation/Translator/StaticTranslation.php

@@ -10,7 +10,7 @@
 class StaticTranslation implements TranslatorInterface {
 
   /**
-   * String translations
+   * String translations.
    *
    * @var array
    *   Array of cached translations indexed by language and context.

core/lib/Drupal/Core/Template/TwigEnvironment.php

@@ -144,7 +144,7 @@ public function invalidate() {
   }
 
   /**
-   * Get the cache prefixed used by \Drupal\Core\Template\TwigPhpStorageCache
+   * Get the cache prefixed used by \Drupal\Core\Template\TwigPhpStorageCache.
    *
    * @return string
    *   The file cache prefix, or empty string if the cache is disabled.

core/lib/Drupal/Core/Url.php

@@ -42,7 +42,7 @@ class Url implements TrustedCallbackInterface {
   protected $urlAssembler;
 
   /**
-   * The access manager
+   * The access manager.
    *
    * @var \Drupal\Core\Access\AccessManagerInterface
    */

core/lib/Drupal/Core/Utility/UnroutedUrlAssembler.php

@@ -162,7 +162,7 @@ protected function buildLocalUrl($uri, array $options = [], $collect_bubbleable_
   }
 
   /**
-   * Merges in default defaults
+   * Merges in default defaults.
    *
    * @param array $options
    *   The options to merge in the defaults.

core/modules/block/src/BlockAccessControlHandler.php

@@ -53,7 +53,7 @@ public static function createInstance(ContainerInterface $container, EntityTypeI
   }
 
   /**
-   * Constructs the block access control handler instance
+   * Constructs the block access control handler instance.
    *
    * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
    *   The entity type definition.

core/modules/block/tests/modules/block_test/src/Controller/TestMultipleFormController.php

@@ -6,7 +6,7 @@
 use Drupal\Core\Form\FormState;
 
 /**
- * Controller for block_test module
+ * Controller for block_test module.
  */
 class TestMultipleFormController extends ControllerBase {
 

core/modules/block/tests/src/Functional/BlockFormInBlockTest.php

@@ -65,7 +65,7 @@ public function testCachePerPage() {
   }
 
   /**
-   * Test the actual placeholders
+   * Test the actual placeholders.
    */
   public function testPlaceholders() {
     $this->drupalGet('test-multiple-forms');

core/modules/block_content/tests/src/Functional/BlockContentTestBase.php

@@ -19,7 +19,7 @@ abstract class BlockContentTestBase extends BrowserTestBase {
   protected $profile = 'testing';
 
   /**
-   * Admin user
+   * Admin user.
    *
    * @var \Drupal\user\UserInterface
    */

core/modules/block_content/tests/src/Functional/Views/BlockContentTestBase.php

@@ -14,7 +14,7 @@
 abstract class BlockContentTestBase extends ViewTestBase {
 
   /**
-   * Admin user
+   * Admin user.
    *
    * @var object
    */

core/modules/comment/src/CommentTypeForm.php

@@ -50,7 +50,7 @@ public static function create(ContainerInterface $container) {
   }
 
   /**
-   * Constructs a CommentTypeFormController
+   * Constructs a CommentTypeFormController.
    *
    * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
    *   The entity type manager service.

core/modules/comment/tests/src/Kernel/Views/CommentUserNameTest.php

@@ -12,7 +12,7 @@
 use Drupal\views\Views;
 
 /**
- * Tests comment user name field
+ * Tests comment user name field.
  *
  * @group comment
  */

core/modules/content_moderation/tests/src/Kernel/ContentModerationPermissionsTest.php

@@ -43,7 +43,7 @@ public function testPermissions($workflow, $permissions) {
   }
 
   /**
-   * Test cases for ::testPermissions
+   * Test cases for ::testPermissions.
    *
    * @return array
    *   Content moderation permissions based test cases.

core/modules/content_moderation/tests/src/Kernel/ModerationStateFieldItemListTest.php

@@ -205,7 +205,7 @@ public function testModerationStateChanges($initial_state, $final_state, $first_
   }
 
   /**
-   * Data provider for ::testModerationStateChanges
+   * Data provider for ::testModerationStateChanges.
    */
   public function moderationStateChangesTestCases() {
     return [

core/modules/content_translation/src/Plugin/Derivative/ContentTranslationLocalTasks.php

@@ -16,7 +16,7 @@ class ContentTranslationLocalTasks extends DeriverBase implements ContainerDeriv
   use StringTranslationTrait;
 
   /**
-   * The base plugin ID
+   * The base plugin ID.
    *
    * @var string
    */

core/modules/contextual/tests/src/Kernel/ContextualUnitTest.php

@@ -20,7 +20,9 @@ class ContextualUnitTest extends KernelTestBase {
   protected static $modules = ['contextual'];
 
   /**
-   * Provides testcases for testContextualLinksToId() and
+   * Provides testcases for both test functions.
+   *
+   * Used in testContextualLinksToId() and testContextualIdToLinks().
    */
   public function _contextual_links_id_testcases() {
     // Test branch conditions:

core/modules/datetime_range/tests/modules/datetime_range_test/datetime_range_test.module

@@ -2,7 +2,7 @@
 
 /**
  * @file
- * Contains datetime_range_test.module
+ * Contains datetime_range_test.module.
  */
 
 /**

core/modules/field/tests/src/Kernel/String/RawStringFormatterTest.php

@@ -11,7 +11,7 @@
 use Drupal\KernelTests\KernelTestBase;
 
 /**
- * Tests the raw string formatter
+ * Tests the raw string formatter.
  *
  * @group field
  */

core/modules/field_ui/tests/src/Functional/FieldUIDeleteTest.php

@@ -37,7 +37,7 @@ class FieldUIDeleteTest extends BrowserTestBase {
   protected $defaultTheme = 'stark';
 
   /**
-   * Test views to enable
+   * Test views to enable.
    *
    * @var string[]
    */

core/modules/field_ui/tests/src/Kernel/EntityDisplayTest.php

@@ -124,7 +124,7 @@ public function testEntityDisplayCRUD() {
   }
 
   /**
-   * Test sorting of components by name on basic CRUD operations
+   * Test sorting of components by name on basic CRUD operations.
    */
   public function testEntityDisplayCRUDSort() {
     $display = EntityViewDisplay::create([

core/modules/file/src/Plugin/Field/FieldType/FileItem.php

@@ -197,7 +197,7 @@ public function fieldSettingsForm(array $form, FormStateInterface $form_state) {
   }
 
   /**
-   * Form API callback
+   * Form API callback.
    *
    * Removes slashes from the beginning and end of the destination value and
    * ensures that the file directory path is not included at the beginning of the

core/modules/file/src/Plugin/views/field/File.php

@@ -38,7 +38,7 @@ protected function defineOptions() {
   }
 
   /**
-   * Provide link to file option
+   * Provide link to file option.
    */
   public function buildOptionsForm(&$form, FormStateInterface $form_state) {
     $form['link_to_file'] = [

core/modules/filter/tests/filter_test/src/Plugin/Filter/FilterTestAssets.php

@@ -6,7 +6,7 @@
 use Drupal\filter\Plugin\FilterBase;
 
 /**
- * Provides a test filter to attach assets
+ * Provides a test filter to attach assets.
  *
  * @Filter(
  *   id = "filter_test_assets",

core/modules/filter/tests/filter_test/src/Plugin/Filter/FilterTestCacheTags.php

@@ -6,7 +6,7 @@
 use Drupal\filter\Plugin\FilterBase;
 
 /**
- * Provides a test filter to associate cache tags
+ * Provides a test filter to associate cache tags.
  *
  * @Filter(
  *   id = "filter_test_cache_tags",

core/modules/forum/src/ForumManager.php

@@ -65,7 +65,7 @@ class ForumManager implements ForumManagerInterface {
   protected $entityTypeManager;
 
   /**
-   * Database connection
+   * Database connection.
    *
    * @var \Drupal\Core\Database\Connection
    */

core/modules/link/tests/src/Unit/Plugin/Validation/Constraint/LinkExternalProtocolsConstraintValidatorTest.php

@@ -42,7 +42,7 @@ public function testValidate($value, $valid) {
   }
 
   /**
-   * Data provider for ::testValidate
+   * Data provider for ::testValidate.
    */
   public function providerValidate() {
     $data = [];

core/modules/link/tests/src/Unit/Plugin/Validation/Constraint/LinkNotExistingInternalConstraintValidatorTest.php

@@ -39,7 +39,7 @@ public function testValidate($value, $valid) {
   }
 
   /**
-   * Data provider for ::testValidate
+   * Data provider for ::testValidate.
    */
   public function providerValidate() {
     $data = [];

core/modules/locale/tests/src/Functional/LocalePluralFormatTest.php

@@ -158,7 +158,7 @@ public function testGetPluralFormat() {
   }
 
   /**
-   * Tests plural editing of DateFormatter strings
+   * Tests plural editing of DateFormatter strings.
    */
   public function testPluralEditDateFormatter() {
 

core/modules/menu_ui/tests/src/Functional/MenuUiTest.php

@@ -493,7 +493,7 @@ public function doMenuTests() {
   }
 
   /**
-   * Ensures that the proper default values are set when adding a menu link
+   * Ensures that the proper default values are set when adding a menu link.
    */
   protected function doMenuLinkFormDefaultsTest() {
     $this->drupalGet("admin/structure/menu/manage/tools/add");

core/modules/migrate/src/Plugin/Derivative/MigrateEntity.php

@@ -15,7 +15,7 @@ class MigrateEntity implements ContainerDeriverInterface {
   protected $derivatives = [];
 
   /**
-   * The entity definitions
+   * The entity definitions.
    *
    * @var \Drupal\Core\Entity\EntityTypeInterface[]
    */

core/modules/migrate/src/Plugin/Derivative/MigrateEntityRevision.php

@@ -15,7 +15,7 @@ class MigrateEntityRevision implements ContainerDeriverInterface {
   protected $derivatives = [];
 
   /**
-   * The entity definitions
+   * The entity definitions.
    *
    * @var \Drupal\Core\Entity\EntityTypeInterface[]
    */

core/modules/migrate/tests/src/Kernel/MigrationPluginManagerTest.php

@@ -17,7 +17,7 @@ class MigrationPluginManagerTest extends MigrateTestBase {
   protected static $modules = ['migrate', 'migrate_tag_test'];
 
   /**
-   * The migration plugin manager
+   * The migration plugin manager.
    *
    * @var \Drupal\migrate\Plugin\MigrationPluginManager
    */
@@ -50,7 +50,7 @@ public function testCreateInstancesByTag($tags, $expected) {
   }
 
   /**
-   * Data provider for testCreateInstancesByTag
+   * Data provider for testCreateInstancesByTag.
    */
   public function providerCreateInstanceByTag() {
     return [

core/modules/migrate/tests/src/Unit/Plugin/migrate/destination/EntityContentBaseTest.php

@@ -2,7 +2,7 @@
 
 /**
  * @file
- * Contains \Drupal\Tests\migrate\Unit\Plugin\migrate\destination\EntityContentBaseTest
+ * Contains \Drupal\Tests\migrate\Unit\Plugin\migrate\destination\EntityContentBaseTest.
  */
 
 namespace Drupal\Tests\migrate\Unit\Plugin\migrate\destination;

core/modules/migrate/tests/src/Unit/Plugin/migrate/destination/EntityTestBase.php

@@ -2,7 +2,7 @@
 
 /**
  * @file
- * Contains \Drupal\Tests\migrate\Unit\Plugin\migrate\destination\EntityTestBase
+ * Contains \Drupal\Tests\migrate\Unit\Plugin\migrate\destination\EntityTestBase.
  */
 
 namespace Drupal\Tests\migrate\Unit\Plugin\migrate\destination;

core/modules/migrate_drupal/migrate_drupal.install

@@ -2,7 +2,7 @@
 
 /**