From f88694094f7883ece3c5b0a757b0bd74992d3a27 Mon Sep 17 00:00:00 2001 From: catch <catch@35733.no-reply.drupal.org> Date: Wed, 5 Apr 2023 11:25:49 +0100 Subject: [PATCH] Revert "Issue #3268809 by quietone, Rishabh Vishwakarma, ravi.shankar, Medha Kumari, mrinalini9, JatinGupta40, smustgrave, xjm, longwave: Fix class comment doc blocks in tests for 'Drupal.Commenting.DocComment.ShortSingleLine'" This reverts commit b4829d2ff71afa897e18f959fd3be5367dc2a728. --- .../action/tests/src/Functional/ConfigurationTest.php | 3 ++- .../block/tests/src/Functional/BlockHiddenRegionTest.php | 3 ++- .../tests/src/Functional/BlockInvalidRegionTest.php | 3 ++- .../block/tests/src/Functional/BlockLanguageTest.php | 3 ++- .../comment/tests/src/Functional/CommentTitleTest.php | 3 ++- .../tests/src/Functional/CommentTokenReplaceTest.php | 3 ++- .../src/Kernel/CommentDefaultFormatterCacheTagsTest.php | 3 ++- .../src/Functional/ConfigInstallProfileOverrideTest.php | 6 ++---- .../config/tests/src/Functional/ConfigInstallWebTest.php | 6 ++---- .../src/Functional/ContextualDynamicContextTest.php | 3 ++- core/modules/dblog/tests/src/Functional/DbLogTest.php | 3 ++- .../dblog/tests/src/Functional/DbLogViewsTest.php | 3 ++- .../src/Functional/FieldImportDeleteUninstallUiTest.php | 3 ++- .../field/tests/src/Kernel/FieldDataCountTest.php | 3 ++- .../tests/src/Kernel/FieldImportDeleteUninstallTest.php | 3 ++- .../file/tests/src/Functional/FileFieldValidateTest.php | 6 ++---- .../file/tests/src/Functional/FileManagedTestBase.php | 3 ++- .../file/tests/src/Functional/FileTokenReplaceTest.php | 3 ++- .../src/FunctionalJavascript/FileFieldValidateTest.php | 6 ++---- .../file/tests/src/Kernel/FileManagedUnitTestBase.php | 3 ++- .../filter/tests/src/Functional/FilterSecurityTest.php | 4 +++- .../src/Functional/LanguageListModuleInstallTest.php | 3 ++- .../tests/src/Kernel/Condition/LanguageConditionTest.php | 3 ++- .../tests/src/Kernel/LanguageDependencyInjectionTest.php | 3 ++- .../Migrate/d6/MigrateLanguageContentSettingsTest.php | 4 +--- .../Migrate/d7/MigrateLanguageContentSettingsTest.php | 4 +--- .../src/EventSubscriber/TestPrepareLayout.php | 3 ++- .../locale/tests/src/Functional/LocaleContentTest.php | 3 ++- .../tests/src/Functional/LocaleTranslationUiTest.php | 3 ++- .../Kernel/MenuLinkContentCacheabilityBubblingTest.php | 5 ++--- core/modules/menu_ui/tests/src/Functional/MenuUiTest.php | 6 ++---- .../modules/migrate/tests/src/Unit/MigrateSourceTest.php | 6 ++---- .../src/Functional/NodeAccessRebuildNodeGrantsTest.php | 3 ++- .../node/tests/src/Functional/NodePostSettingsTest.php | 3 ++- .../node/tests/src/Functional/NodeRevisionsAllTest.php | 3 ++- .../node/tests/src/Functional/NodeRevisionsTest.php | 3 ++- .../node/tests/src/Functional/NodeTitleXSSTest.php | 3 ++- .../Kernel/NodeAccessLanguageAwareCombinationTest.php | 3 ++- .../tests/src/Kernel/NodeAccessLanguageAwareTest.php | 3 ++- .../node/tests/src/Kernel/NodeAccessLanguageTest.php | 3 ++- .../node/tests/src/Kernel/NodeTokenReplaceTest.php | 3 ++- core/modules/path/tests/src/Functional/PathAliasTest.php | 3 ++- .../Functional/EntityResource/EntityResourceTestBase.php | 2 -- .../Unit/Normalizer/DateTimeIso8601NormalizerTest.php | 2 -- .../tests/src/Unit/Normalizer/DateTimeNormalizerTest.php | 2 -- .../src/Unit/Normalizer/TimestampNormalizerTest.php | 2 -- .../tests/src/Functional/StatisticsTokenReplaceTest.php | 3 ++- .../src/Form/AjaxFormsTestAjaxElementsForm.php | 3 ++- .../src/EventSubscriber.php | 6 ++---- .../plugin_test/mock_block/TypedDataStringBlock.php | 4 ++-- .../tests/src/Functional/Entity/EntityRevisionsTest.php | 3 ++- .../src/Functional/FileTransfer/FileTransferTest.php | 3 ++- .../system/tests/src/Functional/Form/CheckboxTest.php | 5 ++--- .../src/Functional/Form/LanguageSelectElementTest.php | 3 ++- .../src/Functional/Form/StateValuesCleanAdvancedTest.php | 4 +++- .../tests/src/Functional/Form/StateValuesCleanTest.php | 5 ++--- .../system/tests/src/Functional/Form/StorageTest.php | 3 ++- .../system/tests/src/Functional/System/DateTimeTest.php | 3 ++- .../system/tests/src/Functional/System/ThemeTest.php | 3 ++- .../src/Functional/Theme/EntityFilteringThemeTest.php | 3 ++- .../Functional/Theme/ThemeEarlyInitializationTest.php | 3 ++- .../UpdateSystem/DependencyHookInvocationTest.php | 3 ++- .../Functional/UpdateSystem/InvalidUpdateHookTest.php | 3 ++- .../src/Functional/UpdateSystem/UpdatesWith7xTest.php | 3 ++- core/modules/system/tests/src/Kernel/Common/UrlTest.php | 9 +++++---- .../tests/src/Kernel/Token/TokenReplaceKernelTest.php | 3 ++- core/modules/taxonomy/tests/src/Functional/RssTest.php | 3 ++- .../taxonomy/tests/src/Functional/TokenReplaceTest.php | 3 ++- .../update/tests/src/Functional/UpdateContribTest.php | 3 ++- .../update/tests/src/Functional/UpdateSemverCoreTest.php | 3 ++- .../tests/src/Functional/UserLanguageCreationTest.php | 3 ++- .../user/tests/src/Functional/UserPermissionsTest.php | 3 ++- .../modules/user/tests/src/Functional/UserSearchTest.php | 3 ++- .../user/tests/src/Functional/UserTokenReplaceTest.php | 3 ++- .../user/tests/src/Kernel/UserAccountFormFieldsTest.php | 3 ++- .../user/tests/src/Kernel/UserActionConfigSchemaTest.php | 3 ++- core/modules/user/tests/src/Traits/UserCreationTrait.php | 3 ++- .../tests/src/Functional/Wizard/ItemsPerPageTest.php | 3 ++- .../Kernel/Handler/FilterBooleanOperatorStringTest.php | 3 ++- .../Kernel/SystemListingCrossProfileCompatibleTest.php | 3 ++- .../FunctionalJavascriptTests/Ajax/MultiFormTest.php | 3 ++- core/tests/Drupal/FunctionalTests/FolderTest.php | 4 ++-- .../Installer/InstallerExistingDatabaseSettingsTest.php | 3 ++- .../Installer/InstallerSiteConfigProfileTest.php | 3 ++- core/tests/Drupal/FunctionalTests/MailCaptureTest.php | 6 ++---- core/tests/Drupal/KernelTests/Core/Common/SizeTest.php | 3 ++- .../tests/Drupal/KernelTests/Core/Common/XssUnitTest.php | 7 ++----- .../KernelTests/Core/Config/ConfigEntityStorageTest.php | 3 ++- .../Core/Config/ConfigOverridesPriorityTest.php | 9 ++------- .../KernelTests/Core/Entity/EntityCrudHookTest.php | 2 -- core/tests/Drupal/KernelTests/Core/File/FileTestBase.php | 3 ++- .../tests/Drupal/KernelTests/Core/Form/FormCacheTest.php | 6 ++---- .../Core/Plugin/Condition/RequestPathTest.php | 3 ++- .../CustomDirectoryAnnotatedClassDiscoveryTest.php | 3 ++- .../TypedData/ComplexDataConstraintValidatorTest.php | 3 ++- 95 files changed, 183 insertions(+), 152 deletions(-) diff --git a/core/modules/action/tests/src/Functional/ConfigurationTest.php b/core/modules/action/tests/src/Functional/ConfigurationTest.php index 8844cb0979b7..051ba5032b73 100644 --- a/core/modules/action/tests/src/Functional/ConfigurationTest.php +++ b/core/modules/action/tests/src/Functional/ConfigurationTest.php @@ -6,7 +6,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests complex actions configuration. + * Tests complex actions configuration by adding, editing, and deleting a + * complex action. * * @group action */ diff --git a/core/modules/block/tests/src/Functional/BlockHiddenRegionTest.php b/core/modules/block/tests/src/Functional/BlockHiddenRegionTest.php index 7f5906be7d78..06cbe8b23705 100644 --- a/core/modules/block/tests/src/Functional/BlockHiddenRegionTest.php +++ b/core/modules/block/tests/src/Functional/BlockHiddenRegionTest.php @@ -5,7 +5,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests that blocks are not added to hidden regions on theme installation. + * Tests that a newly installed theme does not inherit blocks to its hidden + * regions. * * @group block */ diff --git a/core/modules/block/tests/src/Functional/BlockInvalidRegionTest.php b/core/modules/block/tests/src/Functional/BlockInvalidRegionTest.php index 9a0052b07a2f..f11dc77fd371 100644 --- a/core/modules/block/tests/src/Functional/BlockInvalidRegionTest.php +++ b/core/modules/block/tests/src/Functional/BlockInvalidRegionTest.php @@ -6,7 +6,8 @@ use Drupal\block\Entity\Block; /** - * Tests that blocks assigned to invalid regions are disabled with a warning. + * Tests that an active block assigned to a non-existing region triggers the + * warning message and is disabled. * * @group block */ diff --git a/core/modules/block/tests/src/Functional/BlockLanguageTest.php b/core/modules/block/tests/src/Functional/BlockLanguageTest.php index 95c2b3fa4df0..7020fd5df9c0 100644 --- a/core/modules/block/tests/src/Functional/BlockLanguageTest.php +++ b/core/modules/block/tests/src/Functional/BlockLanguageTest.php @@ -6,7 +6,8 @@ use Drupal\block\Entity\Block; /** - * Tests per-language block configuration. + * Tests if a block can be configured to be only visible on a particular + * language. * * @group block */ diff --git a/core/modules/comment/tests/src/Functional/CommentTitleTest.php b/core/modules/comment/tests/src/Functional/CommentTitleTest.php index 5f94a88e9a25..69d65cf4851e 100644 --- a/core/modules/comment/tests/src/Functional/CommentTitleTest.php +++ b/core/modules/comment/tests/src/Functional/CommentTitleTest.php @@ -3,7 +3,8 @@ namespace Drupal\Tests\comment\Functional; /** - * Tests that appropriate and accessible markup is created for comment titles. + * Tests to ensure that appropriate and accessible markup is created for comment + * titles. * * @group comment */ diff --git a/core/modules/comment/tests/src/Functional/CommentTokenReplaceTest.php b/core/modules/comment/tests/src/Functional/CommentTokenReplaceTest.php index 40a6484ebb7f..4fffc6e042de 100644 --- a/core/modules/comment/tests/src/Functional/CommentTokenReplaceTest.php +++ b/core/modules/comment/tests/src/Functional/CommentTokenReplaceTest.php @@ -13,7 +13,8 @@ use Drupal\user\Entity\User; /** - * Tests comment token replacement. + * Generates text using placeholders for dummy content to check comment token + * replacement. * * @group comment */ diff --git a/core/modules/comment/tests/src/Kernel/CommentDefaultFormatterCacheTagsTest.php b/core/modules/comment/tests/src/Kernel/CommentDefaultFormatterCacheTagsTest.php index a0dd05c23a83..4df8d4cd51fc 100644 --- a/core/modules/comment/tests/src/Kernel/CommentDefaultFormatterCacheTagsTest.php +++ b/core/modules/comment/tests/src/Kernel/CommentDefaultFormatterCacheTagsTest.php @@ -12,7 +12,8 @@ use Drupal\entity_test\Entity\EntityTest; /** - * Tests comment cache tag bubbling up when using the Comment list formatter. + * Tests the bubbling up of comment cache tags when using the Comment list + * formatter on an entity. * * @group comment */ diff --git a/core/modules/config/tests/src/Functional/ConfigInstallProfileOverrideTest.php b/core/modules/config/tests/src/Functional/ConfigInstallProfileOverrideTest.php index 4a5ca18c7a26..e022d5f126d3 100644 --- a/core/modules/config/tests/src/Functional/ConfigInstallProfileOverrideTest.php +++ b/core/modules/config/tests/src/Functional/ConfigInstallProfileOverrideTest.php @@ -12,10 +12,8 @@ use Drupal\user\Entity\Role; /** - * Tests that configuration objects are correct after various operations. - * - * The installation and removal of configuration objects in install, disable - * and uninstall functionality is tested. + * Tests installation and removal of configuration objects in install, disable + * and uninstall functionality. * * @group config */ diff --git a/core/modules/config/tests/src/Functional/ConfigInstallWebTest.php b/core/modules/config/tests/src/Functional/ConfigInstallWebTest.php index 314c3d50dbb4..fc27b7d9bd80 100644 --- a/core/modules/config/tests/src/Functional/ConfigInstallWebTest.php +++ b/core/modules/config/tests/src/Functional/ConfigInstallWebTest.php @@ -11,10 +11,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests configuration objects before and after module install and uninstall. - * - * The installation and removal of configuration objects in install, disable - * and uninstall functionality is tested. + * Tests installation and removal of configuration objects in install, disable + * and uninstall functionality. * * @group config */ diff --git a/core/modules/contextual/tests/src/Functional/ContextualDynamicContextTest.php b/core/modules/contextual/tests/src/Functional/ContextualDynamicContextTest.php index b04f716a56b6..f1fb389b0d8e 100644 --- a/core/modules/contextual/tests/src/Functional/ContextualDynamicContextTest.php +++ b/core/modules/contextual/tests/src/Functional/ContextualDynamicContextTest.php @@ -10,7 +10,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests contextual link display on the front page based on permissions. + * Tests if contextual links are showing on the front page depending on + * permissions. * * @group contextual */ diff --git a/core/modules/dblog/tests/src/Functional/DbLogTest.php b/core/modules/dblog/tests/src/Functional/DbLogTest.php index 9f16b406fb53..173c17795aea 100644 --- a/core/modules/dblog/tests/src/Functional/DbLogTest.php +++ b/core/modules/dblog/tests/src/Functional/DbLogTest.php @@ -14,7 +14,8 @@ use Drupal\Tests\system\Functional\Menu\AssertBreadcrumbTrait; /** - * Verifies log entries and user access based on permissions. + * Generate events and verify dblog entries; verify user access to log reports + * based on permissions. * * @group dblog */ diff --git a/core/modules/dblog/tests/src/Functional/DbLogViewsTest.php b/core/modules/dblog/tests/src/Functional/DbLogViewsTest.php index d6794a01c49b..284b3bab9b9a 100644 --- a/core/modules/dblog/tests/src/Functional/DbLogViewsTest.php +++ b/core/modules/dblog/tests/src/Functional/DbLogViewsTest.php @@ -5,7 +5,8 @@ use Drupal\views\Views; /** - * Verifies user access to log reports based on permissions. + * Generate events and verify dblog entries; verify user access to log reports + * based on permissions. Using the dblog UI generated by a View. * * @see Drupal\dblog\Tests\DbLogTest * diff --git a/core/modules/field/tests/src/Functional/FieldImportDeleteUninstallUiTest.php b/core/modules/field/tests/src/Functional/FieldImportDeleteUninstallUiTest.php index 0ab8be68cac6..b7dbac9c98c5 100644 --- a/core/modules/field/tests/src/Functional/FieldImportDeleteUninstallUiTest.php +++ b/core/modules/field/tests/src/Functional/FieldImportDeleteUninstallUiTest.php @@ -7,7 +7,8 @@ use Drupal\field\Entity\FieldStorageConfig; /** - * Tests deleting field storage when a module in uninstalled through the UI. + * Delete field storages and fields during config synchronization and uninstall + * module that provides the field type through the UI. * * @group field * @see \Drupal\field\ConfigImporterFieldPurger diff --git a/core/modules/field/tests/src/Kernel/FieldDataCountTest.php b/core/modules/field/tests/src/Kernel/FieldDataCountTest.php index f521d6236bab..4b067276c3da 100644 --- a/core/modules/field/tests/src/Kernel/FieldDataCountTest.php +++ b/core/modules/field/tests/src/Kernel/FieldDataCountTest.php @@ -10,7 +10,8 @@ use Drupal\field\Entity\FieldStorageConfig; /** - * Tests the count of field data records. + * Tests counting field data records and the hasData() method on + * FieldStorageConfig entity. * * @group field * @see \Drupal\Core\Entity\FieldableEntityStorageInterface::countFieldData() diff --git a/core/modules/field/tests/src/Kernel/FieldImportDeleteUninstallTest.php b/core/modules/field/tests/src/Kernel/FieldImportDeleteUninstallTest.php index 9e2e27bac4cc..48e553cd32c4 100644 --- a/core/modules/field/tests/src/Kernel/FieldImportDeleteUninstallTest.php +++ b/core/modules/field/tests/src/Kernel/FieldImportDeleteUninstallTest.php @@ -7,7 +7,8 @@ use Drupal\field\Entity\FieldStorageConfig; /** - * Tests field storages and fields deletion during config synchronization. + * Delete field storages and fields during config synchronization and uninstall + * module that provides the field type. * * @group field * @see \Drupal\field\ConfigImporterFieldPurger diff --git a/core/modules/file/tests/src/Functional/FileFieldValidateTest.php b/core/modules/file/tests/src/Functional/FileFieldValidateTest.php index 292d24abc07c..005bc1badbba 100644 --- a/core/modules/file/tests/src/Functional/FileFieldValidateTest.php +++ b/core/modules/file/tests/src/Functional/FileFieldValidateTest.php @@ -8,10 +8,8 @@ use Drupal\file\Entity\File; /** - * Tests file field validation functions. - * - * Values validated include the file type, max file size, max size per node, - * and whether the field is required. + * Tests validation functions such as file type, max file size, max size per + * node, and required. * * @group file */ diff --git a/core/modules/file/tests/src/Functional/FileManagedTestBase.php b/core/modules/file/tests/src/Functional/FileManagedTestBase.php index 61a0f5b76ba7..689dd3b7b1ec 100644 --- a/core/modules/file/tests/src/Functional/FileManagedTestBase.php +++ b/core/modules/file/tests/src/Functional/FileManagedTestBase.php @@ -8,7 +8,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Provides a base class for testing files with the file_test module. + * Base class for file tests that use the file_test module to test uploads and + * hooks. */ abstract class FileManagedTestBase extends BrowserTestBase { diff --git a/core/modules/file/tests/src/Functional/FileTokenReplaceTest.php b/core/modules/file/tests/src/Functional/FileTokenReplaceTest.php index 86fe0ed5d176..041b0fe20ed3 100644 --- a/core/modules/file/tests/src/Functional/FileTokenReplaceTest.php +++ b/core/modules/file/tests/src/Functional/FileTokenReplaceTest.php @@ -8,7 +8,8 @@ use Drupal\file\Entity\File; /** - * Tests file token replacement. + * Generates text using placeholders for dummy content to check file token + * replacement. * * @group file */ diff --git a/core/modules/file/tests/src/FunctionalJavascript/FileFieldValidateTest.php b/core/modules/file/tests/src/FunctionalJavascript/FileFieldValidateTest.php index 1d50b3bfd7a4..6c667ecd1261 100644 --- a/core/modules/file/tests/src/FunctionalJavascript/FileFieldValidateTest.php +++ b/core/modules/file/tests/src/FunctionalJavascript/FileFieldValidateTest.php @@ -7,10 +7,8 @@ use Drupal\Tests\TestFileCreationTrait; /** - * Tests file field validation functions. - * - * Values validated include the file type, max file size, max size per node, - * and whether the field is required. + * Tests validation functions such as file type, max file size, max size per + * node, and required. * * @group file */ diff --git a/core/modules/file/tests/src/Kernel/FileManagedUnitTestBase.php b/core/modules/file/tests/src/Kernel/FileManagedUnitTestBase.php index d2ad5dab9691..4441fd333f91 100644 --- a/core/modules/file/tests/src/Kernel/FileManagedUnitTestBase.php +++ b/core/modules/file/tests/src/Kernel/FileManagedUnitTestBase.php @@ -9,7 +9,8 @@ use Drupal\user\Entity\User; /** - * Provides a base class for testing file uploads and hook invocations. + * Base class for file unit tests that use the file_test module to test uploads and + * hooks. */ abstract class FileManagedUnitTestBase extends KernelTestBase { diff --git a/core/modules/filter/tests/src/Functional/FilterSecurityTest.php b/core/modules/filter/tests/src/Functional/FilterSecurityTest.php index ebe5a7877478..0e200f16c6f7 100644 --- a/core/modules/filter/tests/src/Functional/FilterSecurityTest.php +++ b/core/modules/filter/tests/src/Functional/FilterSecurityTest.php @@ -8,7 +8,9 @@ use Drupal\user\RoleInterface; /** - * Tests HTML filtering with missing or skipped filters or text formats. + * Tests the behavior of check_markup() when a filter or text format vanishes, + * or when check_markup() is called in such a way that it is instructed to skip + * all filters of the "FilterInterface::TYPE_HTML_RESTRICTOR" type. * * @group filter */ diff --git a/core/modules/language/tests/src/Functional/LanguageListModuleInstallTest.php b/core/modules/language/tests/src/Functional/LanguageListModuleInstallTest.php index 2b3fcf49e3ab..9a7e9ddabec2 100644 --- a/core/modules/language/tests/src/Functional/LanguageListModuleInstallTest.php +++ b/core/modules/language/tests/src/Functional/LanguageListModuleInstallTest.php @@ -5,7 +5,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests that the language list is not empty when language is installed. + * Tests enabling Language if a module exists that calls + * LanguageManager::getLanguages() during installation. * * @group language */ diff --git a/core/modules/language/tests/src/Kernel/Condition/LanguageConditionTest.php b/core/modules/language/tests/src/Kernel/Condition/LanguageConditionTest.php index 2175a3a9ee08..d664fd5b435a 100644 --- a/core/modules/language/tests/src/Kernel/Condition/LanguageConditionTest.php +++ b/core/modules/language/tests/src/Kernel/Condition/LanguageConditionTest.php @@ -6,7 +6,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests the language condition plugin. + * Tests that the language condition, provided by the language module, is + * working properly. * * @group language */ diff --git a/core/modules/language/tests/src/Kernel/LanguageDependencyInjectionTest.php b/core/modules/language/tests/src/Kernel/LanguageDependencyInjectionTest.php index 954614d3a5d9..dff6af4c2b37 100644 --- a/core/modules/language/tests/src/Kernel/LanguageDependencyInjectionTest.php +++ b/core/modules/language/tests/src/Kernel/LanguageDependencyInjectionTest.php @@ -6,7 +6,8 @@ use Drupal\language\Exception\DeleteDefaultLanguageException; /** - * Tests that a language object can be injected. + * Compares the default language from $GLOBALS against the dependency injected + * language object. * * @group language */ diff --git a/core/modules/language/tests/src/Kernel/Migrate/d6/MigrateLanguageContentSettingsTest.php b/core/modules/language/tests/src/Kernel/Migrate/d6/MigrateLanguageContentSettingsTest.php index 9a3d46335c34..394e18e591c6 100644 --- a/core/modules/language/tests/src/Kernel/Migrate/d6/MigrateLanguageContentSettingsTest.php +++ b/core/modules/language/tests/src/Kernel/Migrate/d6/MigrateLanguageContentSettingsTest.php @@ -6,9 +6,7 @@ use Drupal\Tests\migrate_drupal\Kernel\d6\MigrateDrupal6TestBase; /** - * Tests the migration of language-related settings. - * - * Settings tested include language content setting variables, + * Tests migration of language content setting variables, * language_content_type_$type, i18n_node_options_* and i18n_lock_node_*. * * @group migrate_drupal_6 diff --git a/core/modules/language/tests/src/Kernel/Migrate/d7/MigrateLanguageContentSettingsTest.php b/core/modules/language/tests/src/Kernel/Migrate/d7/MigrateLanguageContentSettingsTest.php index ed65ee448ad6..b86378c2d571 100644 --- a/core/modules/language/tests/src/Kernel/Migrate/d7/MigrateLanguageContentSettingsTest.php +++ b/core/modules/language/tests/src/Kernel/Migrate/d7/MigrateLanguageContentSettingsTest.php @@ -6,9 +6,7 @@ use Drupal\Tests\migrate_drupal\Kernel\d7\MigrateDrupal7TestBase; /** - * Tests the migration of language-related settings. - * - * Settings tested include the language content setting variables, + * Tests migration of language content setting variables, * language_content_type_$type, i18n_node_options_* and i18n_lock_node_*. * * @group migrate_drupal_7 diff --git a/core/modules/layout_builder/tests/modules/layout_builder_element_test/src/EventSubscriber/TestPrepareLayout.php b/core/modules/layout_builder/tests/modules/layout_builder_element_test/src/EventSubscriber/TestPrepareLayout.php index 7162b9671536..0d9c1afd5026 100644 --- a/core/modules/layout_builder/tests/modules/layout_builder_element_test/src/EventSubscriber/TestPrepareLayout.php +++ b/core/modules/layout_builder/tests/modules/layout_builder_element_test/src/EventSubscriber/TestPrepareLayout.php @@ -12,7 +12,8 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface; /** - * Provides an event subscriber for testing section storage alteration. + * An event subscriber to test altering section storage via the + * \Drupal\layout_builder\Event\PrepareLayoutEvent. * * @see \Drupal\layout_builder\Event\PrepareLayoutEvent * @see \Drupal\layout_builder\Element\LayoutBuilder::prepareLayout() diff --git a/core/modules/locale/tests/src/Functional/LocaleContentTest.php b/core/modules/locale/tests/src/Functional/LocaleContentTest.php index 2a06080046d0..ce06b9d2a3f1 100644 --- a/core/modules/locale/tests/src/Functional/LocaleContentTest.php +++ b/core/modules/locale/tests/src/Functional/LocaleContentTest.php @@ -7,7 +7,8 @@ use Drupal\node\NodeInterface; /** - * Tests multilingual support for content types and individual nodes. + * Tests you can enable multilingual support on content types and configure a + * language for a node. * * @group locale */ diff --git a/core/modules/locale/tests/src/Functional/LocaleTranslationUiTest.php b/core/modules/locale/tests/src/Functional/LocaleTranslationUiTest.php index cbca227ad7fa..cdedb12cd35b 100644 --- a/core/modules/locale/tests/src/Functional/LocaleTranslationUiTest.php +++ b/core/modules/locale/tests/src/Functional/LocaleTranslationUiTest.php @@ -9,7 +9,8 @@ use Drupal\Core\Language\LanguageInterface; /** - * Tests the validation of translation strings and search results. + * Adds a new locale and translates its name. Checks the validation of + * translation strings and search results. * * @group locale */ diff --git a/core/modules/menu_link_content/tests/src/Kernel/MenuLinkContentCacheabilityBubblingTest.php b/core/modules/menu_link_content/tests/src/Kernel/MenuLinkContentCacheabilityBubblingTest.php index bc1288972936..27b49b27ee89 100644 --- a/core/modules/menu_link_content/tests/src/Kernel/MenuLinkContentCacheabilityBubblingTest.php +++ b/core/modules/menu_link_content/tests/src/Kernel/MenuLinkContentCacheabilityBubblingTest.php @@ -15,9 +15,8 @@ use Symfony\Component\Routing\Route; /** - * Ensures that rendered menu links bubble the necessary bubbleable metadata. - * - * This for outbound path/route processing. + * Ensures that rendered menu links bubble the necessary bubbleable metadata + * for outbound path/route processing. * * @group menu_link_content */ diff --git a/core/modules/menu_ui/tests/src/Functional/MenuUiTest.php b/core/modules/menu_ui/tests/src/Functional/MenuUiTest.php index f6000557d3c2..96411404b562 100644 --- a/core/modules/menu_ui/tests/src/Functional/MenuUiTest.php +++ b/core/modules/menu_ui/tests/src/Functional/MenuUiTest.php @@ -15,10 +15,8 @@ use Drupal\Tests\menu_ui\Traits\MenuUiTrait; /** - * Tests the menu UI. - * - * This test adds a custom menu, adds menu links to the custom menu and the - * Tools menu, checks their data, and deletes them using the UI. + * Add a custom menu, add menu links to the custom menu and Tools menu, check + * their data, and delete them using the UI. * * @group menu_ui */ diff --git a/core/modules/migrate/tests/src/Unit/MigrateSourceTest.php b/core/modules/migrate/tests/src/Unit/MigrateSourceTest.php index 2afddd72d4e4..8f5d2e627d15 100644 --- a/core/modules/migrate/tests/src/Unit/MigrateSourceTest.php +++ b/core/modules/migrate/tests/src/Unit/MigrateSourceTest.php @@ -500,10 +500,8 @@ protected function initializeIterator() { } /** - * Defines a stubbed source plugin with a generator as iterator. - * - * This stub overwrites the $skipCount, $cacheCounts, and $trackChanges - * properties. + * Stubbed source plugin with a generator as iterator. Also it overwrites the + * $skipCount, $cacheCounts and $trackChanges properties. */ class StubSourceGeneratorPlugin extends StubSourcePlugin { diff --git a/core/modules/node/tests/src/Functional/NodeAccessRebuildNodeGrantsTest.php b/core/modules/node/tests/src/Functional/NodeAccessRebuildNodeGrantsTest.php index 50e5e62eb119..31fee1ccd26f 100644 --- a/core/modules/node/tests/src/Functional/NodeAccessRebuildNodeGrantsTest.php +++ b/core/modules/node/tests/src/Functional/NodeAccessRebuildNodeGrantsTest.php @@ -5,7 +5,8 @@ use Drupal\node\Entity\NodeType; /** - * Tests node access rebuild functions with multiple node access modules. + * Ensures that node access rebuild functions work correctly even + * when other modules implements hook_node_grants(). * * @group node */ diff --git a/core/modules/node/tests/src/Functional/NodePostSettingsTest.php b/core/modules/node/tests/src/Functional/NodePostSettingsTest.php index ba22129b36a9..6610cc67e69b 100644 --- a/core/modules/node/tests/src/Functional/NodePostSettingsTest.php +++ b/core/modules/node/tests/src/Functional/NodePostSettingsTest.php @@ -3,7 +3,8 @@ namespace Drupal\Tests\node\Functional; /** - * Tests the node setting for displaying author and date information. + * Tests that the post information (submitted by Username on date) text displays + * appropriately. * * @group node */ diff --git a/core/modules/node/tests/src/Functional/NodeRevisionsAllTest.php b/core/modules/node/tests/src/Functional/NodeRevisionsAllTest.php index b496cf6beb63..a9687f63e7b0 100644 --- a/core/modules/node/tests/src/Functional/NodeRevisionsAllTest.php +++ b/core/modules/node/tests/src/Functional/NodeRevisionsAllTest.php @@ -6,7 +6,8 @@ use Drupal\node\NodeInterface; /** - * Tests global node CRUD operation permissions. + * Create a node with revisions and test viewing, saving, reverting, and + * deleting revisions for user with access to all. * * @group node */ diff --git a/core/modules/node/tests/src/Functional/NodeRevisionsTest.php b/core/modules/node/tests/src/Functional/NodeRevisionsTest.php index d9df596421a6..d6ce481ad1bf 100644 --- a/core/modules/node/tests/src/Functional/NodeRevisionsTest.php +++ b/core/modules/node/tests/src/Functional/NodeRevisionsTest.php @@ -11,7 +11,8 @@ use Drupal\node\NodeInterface; /** - * Tests per-content-type node CRUD operation permissions. + * Create a node with revisions and test viewing, saving, reverting, and + * deleting revisions for users with access for this content type. * * @group node */ diff --git a/core/modules/node/tests/src/Functional/NodeTitleXSSTest.php b/core/modules/node/tests/src/Functional/NodeTitleXSSTest.php index 87d36e2c490f..dcbac6a1ef0a 100644 --- a/core/modules/node/tests/src/Functional/NodeTitleXSSTest.php +++ b/core/modules/node/tests/src/Functional/NodeTitleXSSTest.php @@ -5,7 +5,8 @@ use Drupal\Component\Utility\Html; /** - * Tests that dangerous tags in the node title are escaped. + * Create a node with dangerous tags in its title and test that they are + * escaped. * * @group node */ diff --git a/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareCombinationTest.php b/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareCombinationTest.php index a3202cfc5b85..f8a2e5f0e2be 100644 --- a/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareCombinationTest.php +++ b/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareCombinationTest.php @@ -11,7 +11,8 @@ use Drupal\field\Entity\FieldStorageConfig; /** - * Tests node access with multiple languages and two node access modules. + * Tests node access functionality with multiple languages and two node access + * modules. * * @group node */ diff --git a/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareTest.php b/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareTest.php index c4afd4d319a6..c3fc89d2f28a 100644 --- a/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareTest.php +++ b/core/modules/node/tests/src/Kernel/NodeAccessLanguageAwareTest.php @@ -10,7 +10,8 @@ use Drupal\field\Entity\FieldStorageConfig; /** - * Tests multilingual node access with a language-aware module. + * Tests node_access and select queries with node_access tag functionality with + * multiple languages with node_access_test_language which is language-aware. * * @group node */ diff --git a/core/modules/node/tests/src/Kernel/NodeAccessLanguageTest.php b/core/modules/node/tests/src/Kernel/NodeAccessLanguageTest.php index 29a2e96a58e8..7e9f8873006a 100644 --- a/core/modules/node/tests/src/Kernel/NodeAccessLanguageTest.php +++ b/core/modules/node/tests/src/Kernel/NodeAccessLanguageTest.php @@ -9,7 +9,8 @@ use Drupal\user\Entity\User; /** - * Tests multilingual node access with a module that is not language-aware. + * Tests node_access and select queries with node_access tag functionality with + * multiple languages with a test node access module that is not language-aware. * * @group node */ diff --git a/core/modules/node/tests/src/Kernel/NodeTokenReplaceTest.php b/core/modules/node/tests/src/Kernel/NodeTokenReplaceTest.php index a18faf871e8c..4f10dce72442 100644 --- a/core/modules/node/tests/src/Kernel/NodeTokenReplaceTest.php +++ b/core/modules/node/tests/src/Kernel/NodeTokenReplaceTest.php @@ -9,7 +9,8 @@ use Drupal\Tests\system\Kernel\Token\TokenReplaceKernelTestBase; /** - * Tests node token replacement. + * Generates text using placeholders for dummy content to check node token + * replacement. * * @group node */ diff --git a/core/modules/path/tests/src/Functional/PathAliasTest.php b/core/modules/path/tests/src/Functional/PathAliasTest.php index 79523459afa1..b55a8a4b6b45 100644 --- a/core/modules/path/tests/src/Functional/PathAliasTest.php +++ b/core/modules/path/tests/src/Functional/PathAliasTest.php @@ -7,7 +7,8 @@ use Drupal\Core\Url; /** - * Tests modifying path aliases from the UI. + * Add, edit, delete, and change alias and verify its consistency in the + * database. * * @group path */ diff --git a/core/modules/rest/tests/src/Functional/EntityResource/EntityResourceTestBase.php b/core/modules/rest/tests/src/Functional/EntityResource/EntityResourceTestBase.php index 6fd4da3e873b..49db1df5de80 100644 --- a/core/modules/rest/tests/src/Functional/EntityResource/EntityResourceTestBase.php +++ b/core/modules/rest/tests/src/Functional/EntityResource/EntityResourceTestBase.php @@ -24,8 +24,6 @@ use Psr\Http\Message\ResponseInterface; /** - * Defines a base class for testing all entity resources. - * * Even though there is the generic EntityResource, it's necessary for every * entity type to have its own test, because they each have different fields, * validation constraints, et cetera. It's not because the generic case works, diff --git a/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeIso8601NormalizerTest.php b/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeIso8601NormalizerTest.php index 98ca2ac7d0cd..322223ec8ecf 100644 --- a/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeIso8601NormalizerTest.php +++ b/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeIso8601NormalizerTest.php @@ -256,8 +256,6 @@ public function testDenormalizeNoTargetInstanceOrFieldDefinitionException() { } /** - * Provides a test class for testing DrupalDateTime. - * * Note: Prophecy does not support magic methods. By subclassing and specifying * an explicit method, Prophecy works. * @see https://github.com/phpspec/prophecy/issues/338 diff --git a/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeNormalizerTest.php b/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeNormalizerTest.php index 0d270d5e89f4..fe503e01a2a2 100644 --- a/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeNormalizerTest.php +++ b/core/modules/serialization/tests/src/Unit/Normalizer/DateTimeNormalizerTest.php @@ -178,8 +178,6 @@ public function testDenormalizeException() { /** - * Provides a test class for testing DrupalDateTime. - * * Note: Prophecy does not support magic methods. By subclassing and specifying * an explicit method, Prophecy works. * @see https://github.com/phpspec/prophecy/issues/338 diff --git a/core/modules/serialization/tests/src/Unit/Normalizer/TimestampNormalizerTest.php b/core/modules/serialization/tests/src/Unit/Normalizer/TimestampNormalizerTest.php index 750d9d2997af..b1851ab9e1d3 100644 --- a/core/modules/serialization/tests/src/Unit/Normalizer/TimestampNormalizerTest.php +++ b/core/modules/serialization/tests/src/Unit/Normalizer/TimestampNormalizerTest.php @@ -133,8 +133,6 @@ public function testDenormalizeException() { } /** - * Provides a test class for testing DrupalDateTime. - * * Note: Prophecy does not support magic methods. By subclassing and specifying * an explicit method, Prophecy works. * @see https://github.com/phpspec/prophecy/issues/338 diff --git a/core/modules/statistics/tests/src/Functional/StatisticsTokenReplaceTest.php b/core/modules/statistics/tests/src/Functional/StatisticsTokenReplaceTest.php index 4b81e983f86a..879f16cc90bc 100644 --- a/core/modules/statistics/tests/src/Functional/StatisticsTokenReplaceTest.php +++ b/core/modules/statistics/tests/src/Functional/StatisticsTokenReplaceTest.php @@ -5,7 +5,8 @@ use Drupal\Component\Render\FormattableMarkup; /** - * Tests statistics token replacement. + * Generates text using placeholders for dummy content to check statistics token + * replacement. * * @group statistics */ diff --git a/core/modules/system/tests/modules/ajax_forms_test/src/Form/AjaxFormsTestAjaxElementsForm.php b/core/modules/system/tests/modules/ajax_forms_test/src/Form/AjaxFormsTestAjaxElementsForm.php index 2e774f31fc2a..41a9b6d92ab0 100644 --- a/core/modules/system/tests/modules/ajax_forms_test/src/Form/AjaxFormsTestAjaxElementsForm.php +++ b/core/modules/system/tests/modules/ajax_forms_test/src/Form/AjaxFormsTestAjaxElementsForm.php @@ -7,7 +7,8 @@ use Drupal\Core\Form\FormStateInterface; /** - * Builds a form where each Form API element triggers a simple Ajax callback. + * Form builder: Builds a form that has each FAPI elements triggering a simple + * Ajax callback. * * @internal */ diff --git a/core/modules/system/tests/modules/module_install_class_loader_test1/src/EventSubscriber.php b/core/modules/system/tests/modules/module_install_class_loader_test1/src/EventSubscriber.php index 5b467532bc40..e9e851799f4d 100644 --- a/core/modules/system/tests/modules/module_install_class_loader_test1/src/EventSubscriber.php +++ b/core/modules/system/tests/modules/module_install_class_loader_test1/src/EventSubscriber.php @@ -5,10 +5,8 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface; /** - * Defines an event subscriber that conditionally unsets the event list. - * - * @see Drupal\module_install_class_loader_test2\EventSubscriber - * @see Drupal\Tests\system\Functional\Module\ClassLoaderTest::testMultipleModules() + * An event subscriber that does different things depending on whether classes + * exist. */ class EventSubscriber implements EventSubscriberInterface { diff --git a/core/modules/system/tests/modules/plugin_test/src/Plugin/plugin_test/mock_block/TypedDataStringBlock.php b/core/modules/system/tests/modules/plugin_test/src/Plugin/plugin_test/mock_block/TypedDataStringBlock.php index 8ddf230930a8..5658cbf4240a 100644 --- a/core/modules/system/tests/modules/plugin_test/src/Plugin/plugin_test/mock_block/TypedDataStringBlock.php +++ b/core/modules/system/tests/modules/plugin_test/src/Plugin/plugin_test/mock_block/TypedDataStringBlock.php @@ -7,10 +7,10 @@ use Drupal\Core\Plugin\PluginBase; /** - * Implements a String TypedData contextual block plugin. + * Implementation of a String TypedData contextual block plugin used by Plugin + * API context test. * * @see \Drupal\plugin_test\Plugin\MockBlockManager - * @see \Drupal\KernelTests\Core\Plugin\PluginTestBase */ class TypedDataStringBlock extends PluginBase implements ContextAwarePluginInterface { diff --git a/core/modules/system/tests/src/Functional/Entity/EntityRevisionsTest.php b/core/modules/system/tests/src/Functional/Entity/EntityRevisionsTest.php index 099ae3767674..dc355f05a8f8 100644 --- a/core/modules/system/tests/src/Functional/Entity/EntityRevisionsTest.php +++ b/core/modules/system/tests/src/Functional/Entity/EntityRevisionsTest.php @@ -10,7 +10,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests modifying an entity with revisions. + * Create a entity with revisions and test viewing, saving, reverting, and + * deleting revisions. * * @group Entity */ diff --git a/core/modules/system/tests/src/Functional/FileTransfer/FileTransferTest.php b/core/modules/system/tests/src/Functional/FileTransfer/FileTransferTest.php index 9ddd26d9bc25..7d6bd2c9d44d 100644 --- a/core/modules/system/tests/src/Functional/FileTransfer/FileTransferTest.php +++ b/core/modules/system/tests/src/Functional/FileTransfer/FileTransferTest.php @@ -7,7 +7,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests recursive file copy operations with the file transfer jail. + * Tests that the jail is respected and that protocols using recursive file move + * operations work. * * @group FileTransfer */ diff --git a/core/modules/system/tests/src/Functional/Form/CheckboxTest.php b/core/modules/system/tests/src/Functional/Form/CheckboxTest.php index ed11505859b6..d5aebdb7f482 100644 --- a/core/modules/system/tests/src/Functional/Form/CheckboxTest.php +++ b/core/modules/system/tests/src/Functional/Form/CheckboxTest.php @@ -6,9 +6,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests the form API checkbox element. - * - * Various combinations of #default_value and #return_value are used. + * Tests form API checkbox handling of various combinations of #default_value + * and #return_value. * * @group Form */ diff --git a/core/modules/system/tests/src/Functional/Form/LanguageSelectElementTest.php b/core/modules/system/tests/src/Functional/Form/LanguageSelectElementTest.php index 26fe1df96ad9..6622ce607c6c 100644 --- a/core/modules/system/tests/src/Functional/Form/LanguageSelectElementTest.php +++ b/core/modules/system/tests/src/Functional/Form/LanguageSelectElementTest.php @@ -8,7 +8,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests the language selection form element. + * Tests that the language select form element prints and submits the right + * options. * * @group Form */ diff --git a/core/modules/system/tests/src/Functional/Form/StateValuesCleanAdvancedTest.php b/core/modules/system/tests/src/Functional/Form/StateValuesCleanAdvancedTest.php index 90e24029f2ef..b6aea0ead694 100644 --- a/core/modules/system/tests/src/Functional/Form/StateValuesCleanAdvancedTest.php +++ b/core/modules/system/tests/src/Functional/Form/StateValuesCleanAdvancedTest.php @@ -6,7 +6,9 @@ use Drupal\Tests\TestFileCreationTrait; /** - * Tests the removal of internal Form API elements from submitted form values. + * Tests proper removal of submitted form values using + * \Drupal\Core\Form\FormState::cleanValues() when having forms with elements + * containing buttons like "managed_file". * * @group Form */ diff --git a/core/modules/system/tests/src/Functional/Form/StateValuesCleanTest.php b/core/modules/system/tests/src/Functional/Form/StateValuesCleanTest.php index 4a2fc2a6a09d..473f98ee5ffc 100644 --- a/core/modules/system/tests/src/Functional/Form/StateValuesCleanTest.php +++ b/core/modules/system/tests/src/Functional/Form/StateValuesCleanTest.php @@ -7,9 +7,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests the proper removal of submitted form values. - * - * @see \Drupal\Core\Form\FormState::cleanValues() + * Tests proper removal of submitted form values using + * \Drupal\Core\Form\FormState::cleanValues(). * * @group Form */ diff --git a/core/modules/system/tests/src/Functional/Form/StorageTest.php b/core/modules/system/tests/src/Functional/Form/StorageTest.php index 9db4723caa4d..385ca20392a8 100644 --- a/core/modules/system/tests/src/Functional/Form/StorageTest.php +++ b/core/modules/system/tests/src/Functional/Form/StorageTest.php @@ -7,7 +7,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests a multistep form using form storage. + * Tests a multistep form using form storage and makes sure validation and + * caching works right. * * The tested form puts data into the storage during the initial form * construction. These tests verify that there are no duplicate form diff --git a/core/modules/system/tests/src/Functional/System/DateTimeTest.php b/core/modules/system/tests/src/Functional/System/DateTimeTest.php index 5ba373205334..8a587973be64 100644 --- a/core/modules/system/tests/src/Functional/System/DateTimeTest.php +++ b/core/modules/system/tests/src/Functional/System/DateTimeTest.php @@ -7,7 +7,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Test date formatting and time zone handling, including daylight saving time. + * Configure date and time settings. Test date formatting and time zone + * handling, including daylight saving time. * * @group system */ diff --git a/core/modules/system/tests/src/Functional/System/ThemeTest.php b/core/modules/system/tests/src/Functional/System/ThemeTest.php index 3ae9a3beec78..d512d9320a41 100644 --- a/core/modules/system/tests/src/Functional/System/ThemeTest.php +++ b/core/modules/system/tests/src/Functional/System/ThemeTest.php @@ -9,7 +9,8 @@ use Drupal\Tests\TestFileCreationTrait; /** - * Tests the theme administration user interface. + * Tests the theme interface functionality by enabling and switching themes, and + * using an administration theme. * * @group system */ diff --git a/core/modules/system/tests/src/Functional/Theme/EntityFilteringThemeTest.php b/core/modules/system/tests/src/Functional/Theme/EntityFilteringThemeTest.php index 0e84329a5401..e5330bab36b4 100644 --- a/core/modules/system/tests/src/Functional/Theme/EntityFilteringThemeTest.php +++ b/core/modules/system/tests/src/Functional/Theme/EntityFilteringThemeTest.php @@ -13,7 +13,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests XSS filtering for themed output for each entity type in all themes. + * Tests themed output for each entity type in all available themes to ensure + * entity labels are filtered for XSS. * * @group Theme */ diff --git a/core/modules/system/tests/src/Functional/Theme/ThemeEarlyInitializationTest.php b/core/modules/system/tests/src/Functional/Theme/ThemeEarlyInitializationTest.php index 4dab6c2ded1b..a01778dd3171 100644 --- a/core/modules/system/tests/src/Functional/Theme/ThemeEarlyInitializationTest.php +++ b/core/modules/system/tests/src/Functional/Theme/ThemeEarlyInitializationTest.php @@ -5,7 +5,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests theme system initialization early in the page request. + * Tests that the theme system can be correctly initialized early in the page + * request. * * @group Theme */ diff --git a/core/modules/system/tests/src/Functional/UpdateSystem/DependencyHookInvocationTest.php b/core/modules/system/tests/src/Functional/UpdateSystem/DependencyHookInvocationTest.php index 561ff795af2b..d263380924b6 100644 --- a/core/modules/system/tests/src/Functional/UpdateSystem/DependencyHookInvocationTest.php +++ b/core/modules/system/tests/src/Functional/UpdateSystem/DependencyHookInvocationTest.php @@ -5,7 +5,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests the hook invocation for determining update dependencies. + * Tests that the hook invocation for determining update dependencies works + * correctly. * * @group Update */ diff --git a/core/modules/system/tests/src/Functional/UpdateSystem/InvalidUpdateHookTest.php b/core/modules/system/tests/src/Functional/UpdateSystem/InvalidUpdateHookTest.php index 0d79aa906d9b..8412ab1f0e52 100644 --- a/core/modules/system/tests/src/Functional/UpdateSystem/InvalidUpdateHookTest.php +++ b/core/modules/system/tests/src/Functional/UpdateSystem/InvalidUpdateHookTest.php @@ -7,7 +7,8 @@ use Drupal\Tests\RequirementsPageTrait; /** - * Tests that hook_update_8000() is disallowed. + * Tests that a module implementing hook_update_8000() causes an error to be + * displayed on update. * * @group Update */ diff --git a/core/modules/system/tests/src/Functional/UpdateSystem/UpdatesWith7xTest.php b/core/modules/system/tests/src/Functional/UpdateSystem/UpdatesWith7xTest.php index 2364e99bdd86..e12b58687314 100644 --- a/core/modules/system/tests/src/Functional/UpdateSystem/UpdatesWith7xTest.php +++ b/core/modules/system/tests/src/Functional/UpdateSystem/UpdatesWith7xTest.php @@ -7,7 +7,8 @@ use Drupal\Tests\RequirementsPageTrait; /** - * Tests the minimum schema version when only 7.x update hooks are retained. + * Tests that the minimum schema version is correct even if only 7.x update + * hooks are retained . * * @group Update */ diff --git a/core/modules/system/tests/src/Kernel/Common/UrlTest.php b/core/modules/system/tests/src/Kernel/Common/UrlTest.php index 22791a7a8532..6ed9d626e3fd 100644 --- a/core/modules/system/tests/src/Kernel/Common/UrlTest.php +++ b/core/modules/system/tests/src/Kernel/Common/UrlTest.php @@ -12,10 +12,11 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests the Url object. - * - * @covers \Drupal\Component\Utility\UrlHelper::filterQueryParameters() - * @covers \Drupal\Core\Utility\LinkGeneratorInterface::generate() + * Confirm that \Drupal\Core\Url, + * \Drupal\Component\Utility\UrlHelper::filterQueryParameters(), + * \Drupal\Component\Utility\UrlHelper::buildQuery(), and + * \Drupal\Core\Utility\LinkGeneratorInterface::generate() + * work correctly with various input. * * @group Common */ diff --git a/core/modules/system/tests/src/Kernel/Token/TokenReplaceKernelTest.php b/core/modules/system/tests/src/Kernel/Token/TokenReplaceKernelTest.php index 2ecff8dcbe6a..06fa062ddd5a 100644 --- a/core/modules/system/tests/src/Kernel/Token/TokenReplaceKernelTest.php +++ b/core/modules/system/tests/src/Kernel/Token/TokenReplaceKernelTest.php @@ -10,7 +10,8 @@ use Symfony\Component\HttpFoundation\Request; /** - * Tests token replacement. + * Generates text using placeholders for dummy content to check token + * replacement. * * @group system */ diff --git a/core/modules/taxonomy/tests/src/Functional/RssTest.php b/core/modules/taxonomy/tests/src/Functional/RssTest.php index 9b434d12928a..6558da831831 100644 --- a/core/modules/taxonomy/tests/src/Functional/RssTest.php +++ b/core/modules/taxonomy/tests/src/Functional/RssTest.php @@ -6,7 +6,8 @@ use Drupal\views\Views; /** - * Tests the taxonomy RSS display. + * Ensure that data added as terms appears in RSS feeds if "RSS Category" format + * is selected. * * @group taxonomy */ diff --git a/core/modules/taxonomy/tests/src/Functional/TokenReplaceTest.php b/core/modules/taxonomy/tests/src/Functional/TokenReplaceTest.php index 87e2811af9d2..383853ab28cd 100644 --- a/core/modules/taxonomy/tests/src/Functional/TokenReplaceTest.php +++ b/core/modules/taxonomy/tests/src/Functional/TokenReplaceTest.php @@ -6,7 +6,8 @@ use Drupal\Core\Render\BubbleableMetadata; /** - * Tests taxonomy token replacement. + * Generates text using placeholders for dummy content to check taxonomy token + * replacement. * * @group taxonomy */ diff --git a/core/modules/update/tests/src/Functional/UpdateContribTest.php b/core/modules/update/tests/src/Functional/UpdateContribTest.php index 294074c592e9..20a0d5eda32a 100644 --- a/core/modules/update/tests/src/Functional/UpdateContribTest.php +++ b/core/modules/update/tests/src/Functional/UpdateContribTest.php @@ -6,7 +6,8 @@ use Drupal\update\UpdateManagerInterface; /** - * Tests how the Update Manager handles contributed modules and themes. + * Tests how the Update Manager module handles contributed modules and themes in + * a series of functional tests using mock XML data. * * @group update */ diff --git a/core/modules/update/tests/src/Functional/UpdateSemverCoreTest.php b/core/modules/update/tests/src/Functional/UpdateSemverCoreTest.php index 829b68dd7b30..d740425fbd60 100644 --- a/core/modules/update/tests/src/Functional/UpdateSemverCoreTest.php +++ b/core/modules/update/tests/src/Functional/UpdateSemverCoreTest.php @@ -5,7 +5,8 @@ use Drupal\Core\Url; /** - * Tests the semantic version handling in the Update Manager. + * Tests the Update Manager module through a series of functional tests using + * mock XML data. * * @group update */ diff --git a/core/modules/user/tests/src/Functional/UserLanguageCreationTest.php b/core/modules/user/tests/src/Functional/UserLanguageCreationTest.php index 4f3478542ae9..94d86b492a74 100644 --- a/core/modules/user/tests/src/Functional/UserLanguageCreationTest.php +++ b/core/modules/user/tests/src/Functional/UserLanguageCreationTest.php @@ -6,7 +6,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests preferred language configuration and language selector access. + * Tests whether proper language is stored for new users and access to language + * selector. * * @group user */ diff --git a/core/modules/user/tests/src/Functional/UserPermissionsTest.php b/core/modules/user/tests/src/Functional/UserPermissionsTest.php index c79c470d8c8c..1c5be8689d07 100644 --- a/core/modules/user/tests/src/Functional/UserPermissionsTest.php +++ b/core/modules/user/tests/src/Functional/UserPermissionsTest.php @@ -7,7 +7,8 @@ use Drupal\user\Entity\Role; /** - * Verifies role permissions can be added and removed via the permissions page. + * Verify that role permissions can be added and removed via the permissions + * pages. * * @group user */ diff --git a/core/modules/user/tests/src/Functional/UserSearchTest.php b/core/modules/user/tests/src/Functional/UserSearchTest.php index 5c013cdbfd11..973dc260266f 100644 --- a/core/modules/user/tests/src/Functional/UserSearchTest.php +++ b/core/modules/user/tests/src/Functional/UserSearchTest.php @@ -5,7 +5,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Verifies that sensitive information is hidden from unauthorized users. + * Tests the user search page and verifies that sensitive information is hidden + * from unauthorized users. * * @group user */ diff --git a/core/modules/user/tests/src/Functional/UserTokenReplaceTest.php b/core/modules/user/tests/src/Functional/UserTokenReplaceTest.php index 2857268a2533..2649f7a8f0ba 100644 --- a/core/modules/user/tests/src/Functional/UserTokenReplaceTest.php +++ b/core/modules/user/tests/src/Functional/UserTokenReplaceTest.php @@ -9,7 +9,8 @@ use Drupal\user\Entity\User; /** - * Tests the replacement of user tokens. + * Generates text using placeholders for dummy content to check user token + * replacement. * * @group user */ diff --git a/core/modules/user/tests/src/Kernel/UserAccountFormFieldsTest.php b/core/modules/user/tests/src/Kernel/UserAccountFormFieldsTest.php index dbc61853452d..1aabea79a8a5 100644 --- a/core/modules/user/tests/src/Kernel/UserAccountFormFieldsTest.php +++ b/core/modules/user/tests/src/Kernel/UserAccountFormFieldsTest.php @@ -6,7 +6,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Verifies the field order in user account forms. + * Verifies that the field order in user account forms is compatible with + * password managers of web browsers. * * @group user */ diff --git a/core/modules/user/tests/src/Kernel/UserActionConfigSchemaTest.php b/core/modules/user/tests/src/Kernel/UserActionConfigSchemaTest.php index 8767c92e1596..527db24aa41c 100644 --- a/core/modules/user/tests/src/Kernel/UserActionConfigSchemaTest.php +++ b/core/modules/user/tests/src/Kernel/UserActionConfigSchemaTest.php @@ -7,7 +7,8 @@ use Drupal\user\Entity\Role; /** - * Tests that the config schema is valid when roles are added or removed. + * Ensures the user action for adding and removing roles have valid config + * schema. * * @group user */ diff --git a/core/modules/user/tests/src/Traits/UserCreationTrait.php b/core/modules/user/tests/src/Traits/UserCreationTrait.php index 683ba355c8ad..92a3101e1816 100644 --- a/core/modules/user/tests/src/Traits/UserCreationTrait.php +++ b/core/modules/user/tests/src/Traits/UserCreationTrait.php @@ -13,7 +13,8 @@ use Drupal\user\RoleInterface; /** - * Provides test methods for user creation and authentication. + * Provides methods to create additional test users and switch the currently + * logged in one. * * This trait is meant to be used only by test classes. */ diff --git a/core/modules/views/tests/src/Functional/Wizard/ItemsPerPageTest.php b/core/modules/views/tests/src/Functional/Wizard/ItemsPerPageTest.php index 61da043cf2df..da9ac54e063e 100644 --- a/core/modules/views/tests/src/Functional/Wizard/ItemsPerPageTest.php +++ b/core/modules/views/tests/src/Functional/Wizard/ItemsPerPageTest.php @@ -3,7 +3,8 @@ namespace Drupal\Tests\views\Functional\Wizard; /** - * Tests that the views wizard can specify the number of items per page. + * Tests the ability of the views wizard to specify the number of items per + * page. * * @group views */ diff --git a/core/modules/views/tests/src/Kernel/Handler/FilterBooleanOperatorStringTest.php b/core/modules/views/tests/src/Kernel/Handler/FilterBooleanOperatorStringTest.php index 66bac02a642f..88c3de207aa3 100644 --- a/core/modules/views/tests/src/Kernel/Handler/FilterBooleanOperatorStringTest.php +++ b/core/modules/views/tests/src/Kernel/Handler/FilterBooleanOperatorStringTest.php @@ -6,7 +6,8 @@ use Drupal\views\Views; /** - * Tests core's BooleanOperatorString views filter handler. + * Tests the core Drupal\views\Plugin\views\filter\BooleanOperatorString + * handler. * * @group views * @see \Drupal\views\Plugin\views\filter\BooleanOperatorString diff --git a/core/profiles/testing/modules/drupal_system_listing_compatible_test/tests/src/Kernel/SystemListingCrossProfileCompatibleTest.php b/core/profiles/testing/modules/drupal_system_listing_compatible_test/tests/src/Kernel/SystemListingCrossProfileCompatibleTest.php index cc4ec230e123..d3a9f0d7e8a6 100644 --- a/core/profiles/testing/modules/drupal_system_listing_compatible_test/tests/src/Kernel/SystemListingCrossProfileCompatibleTest.php +++ b/core/profiles/testing/modules/drupal_system_listing_compatible_test/tests/src/Kernel/SystemListingCrossProfileCompatibleTest.php @@ -5,7 +5,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Verifies that tests in installation profile modules are found. + * Verifies that tests in installation profile modules are found and may use + * another profile for running tests. * * @group drupal_system_listing_compatible_test */ diff --git a/core/tests/Drupal/FunctionalJavascriptTests/Ajax/MultiFormTest.php b/core/tests/Drupal/FunctionalJavascriptTests/Ajax/MultiFormTest.php index d436179b4144..83c26e96e1a6 100644 --- a/core/tests/Drupal/FunctionalJavascriptTests/Ajax/MultiFormTest.php +++ b/core/tests/Drupal/FunctionalJavascriptTests/Ajax/MultiFormTest.php @@ -8,7 +8,8 @@ use Drupal\FunctionalJavascriptTests\WebDriverTestBase; /** - * Tests AJAX-enabled forms when multiple instances of the form are on a page. + * Tests that AJAX-enabled forms work when multiple instances of the same form + * are on a page. * * @group Ajax */ diff --git a/core/tests/Drupal/FunctionalTests/FolderTest.php b/core/tests/Drupal/FunctionalTests/FolderTest.php index 923849e561c8..a8196ebd9255 100644 --- a/core/tests/Drupal/FunctionalTests/FolderTest.php +++ b/core/tests/Drupal/FunctionalTests/FolderTest.php @@ -5,8 +5,8 @@ use Drupal\Tests\BrowserTestBase; /** - * Tests BrowserTestBase's treatment of hook_install() during setup. - * + * This test will check BrowserTestBase's treatment of hook_install during + * setUp. * Image module is used for test. * * @group browsertestbase diff --git a/core/tests/Drupal/FunctionalTests/Installer/InstallerExistingDatabaseSettingsTest.php b/core/tests/Drupal/FunctionalTests/Installer/InstallerExistingDatabaseSettingsTest.php index 53a615b57cd5..ee6caea944fc 100644 --- a/core/tests/Drupal/FunctionalTests/Installer/InstallerExistingDatabaseSettingsTest.php +++ b/core/tests/Drupal/FunctionalTests/Installer/InstallerExistingDatabaseSettingsTest.php @@ -5,7 +5,8 @@ use Drupal\Core\Database\Database; /** - * Tests installation with database information in an existing settings file. + * Tests the installer with an existing settings file with database connection + * info. * * @group Installer */ diff --git a/core/tests/Drupal/FunctionalTests/Installer/InstallerSiteConfigProfileTest.php b/core/tests/Drupal/FunctionalTests/Installer/InstallerSiteConfigProfileTest.php index c09bf838e4ed..097d8451891f 100644 --- a/core/tests/Drupal/FunctionalTests/Installer/InstallerSiteConfigProfileTest.php +++ b/core/tests/Drupal/FunctionalTests/Installer/InstallerSiteConfigProfileTest.php @@ -3,7 +3,8 @@ namespace Drupal\FunctionalTests\Installer; /** - * Verifies that the installer uses the profile's site configuration. + * Verifies that the installer defaults to the existing site email address and + * timezone, if they were provided by the install profile. * * @group Installer */ diff --git a/core/tests/Drupal/FunctionalTests/MailCaptureTest.php b/core/tests/Drupal/FunctionalTests/MailCaptureTest.php index 67f0099704f0..d4bc642e714f 100644 --- a/core/tests/Drupal/FunctionalTests/MailCaptureTest.php +++ b/core/tests/Drupal/FunctionalTests/MailCaptureTest.php @@ -7,10 +7,8 @@ use Drupal\Core\Test\AssertMailTrait; /** - * Tests the collection of emails during testing. - * - * The test mail collector, test.mail.collector, intercepts any email sent - * during a test so it does not leave the test server. + * Tests the email capturing logic, the assertMail assertion and the + * drupalGetMails function. * * @group browsertestbase */ diff --git a/core/tests/Drupal/KernelTests/Core/Common/SizeTest.php b/core/tests/Drupal/KernelTests/Core/Common/SizeTest.php index 77e70784ee34..f595cfcab5ec 100644 --- a/core/tests/Drupal/KernelTests/Core/Common/SizeTest.php +++ b/core/tests/Drupal/KernelTests/Core/Common/SizeTest.php @@ -6,7 +6,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests format_size(). + * Parse a predefined amount of bytes and compare the output with the expected + * value. * * @group Common */ diff --git a/core/tests/Drupal/KernelTests/Core/Common/XssUnitTest.php b/core/tests/Drupal/KernelTests/Core/Common/XssUnitTest.php index 38edb98d36ab..ff7fba57ffac 100644 --- a/core/tests/Drupal/KernelTests/Core/Common/XssUnitTest.php +++ b/core/tests/Drupal/KernelTests/Core/Common/XssUnitTest.php @@ -6,11 +6,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests XSS filtering. - * - * @see \Drupal\Component\Utility\Xss::filter() - * @see \Drupal\Component\Utility\UrlHelper::filterBadProtocol - * @see \Drupal\Component\Utility\UrlHelper::stripDangerousProtocols + * Confirm that \Drupal\Component\Utility\Xss::filter() and check_url() work + * correctly, including invalid multi-byte sequences. * * @group Common */ diff --git a/core/tests/Drupal/KernelTests/Core/Config/ConfigEntityStorageTest.php b/core/tests/Drupal/KernelTests/Core/Config/ConfigEntityStorageTest.php index 325d5cd66a51..91887ecc59e6 100644 --- a/core/tests/Drupal/KernelTests/Core/Config/ConfigEntityStorageTest.php +++ b/core/tests/Drupal/KernelTests/Core/Config/ConfigEntityStorageTest.php @@ -6,7 +6,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests configuration entity storage. + * Tests sync and importing config entities with IDs and UUIDs that match + * existing config. * * @group config */ diff --git a/core/tests/Drupal/KernelTests/Core/Config/ConfigOverridesPriorityTest.php b/core/tests/Drupal/KernelTests/Core/Config/ConfigOverridesPriorityTest.php index b5ca02e95613..7ad4487796e8 100644 --- a/core/tests/Drupal/KernelTests/Core/Config/ConfigOverridesPriorityTest.php +++ b/core/tests/Drupal/KernelTests/Core/Config/ConfigOverridesPriorityTest.php @@ -6,13 +6,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests that config overrides are applied in the correct order. - * - * Overrides should be applied in the following order, from lowest priority - * to highest: - * - Language overrides. - * - Module overrides. - * - settings.php overrides. + * Tests that language, module and settings.php are applied in the correct + * order. * * @group config */ diff --git a/core/tests/Drupal/KernelTests/Core/Entity/EntityCrudHookTest.php b/core/tests/Drupal/KernelTests/Core/Entity/EntityCrudHookTest.php index ff9c257fb427..3cd385531314 100644 --- a/core/tests/Drupal/KernelTests/Core/Entity/EntityCrudHookTest.php +++ b/core/tests/Drupal/KernelTests/Core/Entity/EntityCrudHookTest.php @@ -16,8 +16,6 @@ use Drupal\file\Entity\File; /** - * Tests entity CRUD via hooks. - * * Tests the invocation of hooks when creating, inserting, loading, updating or * deleting an entity. * diff --git a/core/tests/Drupal/KernelTests/Core/File/FileTestBase.php b/core/tests/Drupal/KernelTests/Core/File/FileTestBase.php index ac0376d69622..fe523eecf071 100644 --- a/core/tests/Drupal/KernelTests/Core/File/FileTestBase.php +++ b/core/tests/Drupal/KernelTests/Core/File/FileTestBase.php @@ -6,7 +6,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Provides file-specific assertions and helper functions. + * Base class for file tests that adds some additional file specific + * assertions and helper functions. */ abstract class FileTestBase extends KernelTestBase { diff --git a/core/tests/Drupal/KernelTests/Core/Form/FormCacheTest.php b/core/tests/Drupal/KernelTests/Core/Form/FormCacheTest.php index fe8d614c88a6..9d89caa87ab7 100644 --- a/core/tests/Drupal/KernelTests/Core/Form/FormCacheTest.php +++ b/core/tests/Drupal/KernelTests/Core/Form/FormCacheTest.php @@ -9,10 +9,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests FormBuilder caching. - * - * @covers \Drupal\Core\Form\FormBuilder::getCache - * @covers \Drupal\Core\Form\FormBuilder::setCache + * Tests \Drupal::formBuilder()->setCache() and + * \Drupal::formBuilder()->getCache(). * * @group Form */ diff --git a/core/tests/Drupal/KernelTests/Core/Plugin/Condition/RequestPathTest.php b/core/tests/Drupal/KernelTests/Core/Plugin/Condition/RequestPathTest.php index efbbd9113ef5..be6ec023eeb3 100644 --- a/core/tests/Drupal/KernelTests/Core/Plugin/Condition/RequestPathTest.php +++ b/core/tests/Drupal/KernelTests/Core/Plugin/Condition/RequestPathTest.php @@ -9,7 +9,8 @@ use Symfony\Component\HttpFoundation\RequestStack; /** - * Tests system.module's request path condition. + * Tests that the Request Path Condition, provided by the system module, is + * working properly. * * @group Plugin */ diff --git a/core/tests/Drupal/KernelTests/Core/Plugin/Discovery/CustomDirectoryAnnotatedClassDiscoveryTest.php b/core/tests/Drupal/KernelTests/Core/Plugin/Discovery/CustomDirectoryAnnotatedClassDiscoveryTest.php index c65f0e14f0ec..48f987decceb 100644 --- a/core/tests/Drupal/KernelTests/Core/Plugin/Discovery/CustomDirectoryAnnotatedClassDiscoveryTest.php +++ b/core/tests/Drupal/KernelTests/Core/Plugin/Discovery/CustomDirectoryAnnotatedClassDiscoveryTest.php @@ -6,7 +6,8 @@ use Drupal\Core\StringTranslation\TranslatableMarkup; /** - * Tests discovery of annotated plugins in a custom directory. + * Tests that plugins in a custom directory are correctly discovered using + * annotated classes. * * @group Plugin */ diff --git a/core/tests/Drupal/KernelTests/Core/TypedData/ComplexDataConstraintValidatorTest.php b/core/tests/Drupal/KernelTests/Core/TypedData/ComplexDataConstraintValidatorTest.php index 0d9d06d79710..94b1b33aa934 100644 --- a/core/tests/Drupal/KernelTests/Core/TypedData/ComplexDataConstraintValidatorTest.php +++ b/core/tests/Drupal/KernelTests/Core/TypedData/ComplexDataConstraintValidatorTest.php @@ -7,7 +7,8 @@ use Drupal\KernelTests\KernelTestBase; /** - * Tests ComplexData validation with both valid and invalid values. + * Tests ComplexData validation constraint with both valid and invalid values + * for a key. * * @group Validation */ -- GitLab