Issue #2262195 by sun: Various test classes are missing phpDoc.

core/modules/ban/lib/Drupal/ban/Tests/IpAddressBlockingTest.php

@@ -9,6 +9,9 @@ namespace Drupal\ban\Tests;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests IP address banning.
+ */
 class IpAddressBlockingTest extends WebTestBase {
 
   /**

core/modules/block/lib/Drupal/block/Tests/NonDefaultBlockAdminTest.php

@@ -9,6 +9,9 @@ namespace Drupal\block\Tests;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests the block administration page for a non-default theme.
+ */
 class NonDefaultBlockAdminTest extends WebTestBase {
 
   /**

core/modules/comment/lib/Drupal/comment/Tests/Views/DefaultViewRecentComments.php

@@ -11,6 +11,9 @@ use Drupal\comment\CommentInterface;
 use Drupal\views\Views;
 use Drupal\views\Tests\ViewTestBase;
 
+/**
+ * Tests the Recent Comments default view.
+ */
 class DefaultViewRecentComments extends ViewTestBase {
 
   /**

core/modules/config/lib/Drupal/config/Tests/ConfigImportAllTest.php

@@ -10,6 +10,9 @@ namespace Drupal\config\Tests;
 use Drupal\Core\Config\StorageComparer;
 use Drupal\system\Tests\Module\ModuleTestBase;
 
+/**
+ * Tests importing all configuration from Standard profile and all core modules.
+ */
 class ConfigImportAllTest extends ModuleTestBase {
 
   /**

core/modules/field/lib/Drupal/field/Tests/CrudTest.php

@@ -10,6 +10,9 @@ namespace Drupal\field\Tests;
 use Drupal\Core\Entity\EntityStorageException;
 use Drupal\field\FieldException;
 
+/**
+ * Tests field CRUD operations.
+ */
 class CrudTest extends FieldUnitTestBase {
 
   /**

core/modules/field/lib/Drupal/field/Tests/DisplayApiTest.php

@@ -9,6 +9,9 @@ namespace Drupal\field\Tests;
 
 use Drupal\Core\Language\Language;
 
+/**
+ * Tests the field display API.
+ */
 class DisplayApiTest extends FieldUnitTestBase {
 
   /**

core/modules/field/lib/Drupal/field/Tests/FieldInfoTest.php

@@ -9,6 +9,9 @@ namespace Drupal\field\Tests;
 
 use Drupal\Core\Language\Language;
 
+/**
+ * Tests field information for fields, instances, and bundles.
+ */
 class FieldInfoTest extends FieldUnitTestBase {
 
   public static function getInfo() {

core/modules/field/lib/Drupal/field/Tests/FieldInstanceCrudTest.php

@@ -10,6 +10,9 @@ namespace Drupal\field\Tests;
 use Drupal\Core\Entity\EntityStorageException;
 use Drupal\field\FieldException;
 
+/**
+ * Tests field instance CRUD (attaching fields to entities).
+ */
 class FieldInstanceCrudTest extends FieldUnitTestBase {
 
   /**

core/modules/field/lib/Drupal/field/Tests/FormTest.php

@@ -9,6 +9,9 @@ namespace Drupal\field\Tests;
 
 use Drupal\Core\Field\FieldDefinitionInterface;
 
+/**
+ * Tests field form handling.
+ */
 class FormTest extends FieldTestBase {
 
   /**

core/modules/field/lib/Drupal/field/Tests/NestedFormTest.php

@@ -9,6 +9,9 @@ namespace Drupal\field\Tests;
 
 use Drupal\Core\Field\FieldDefinitionInterface;
 
+/**
+ * Tests field elements in nested forms.
+ */
 class NestedFormTest extends FieldTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateAggregatorFeedTest.php

@@ -12,6 +12,9 @@ use Drupal\Core\Language\Language;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of aggregator feed entities.
+ */
 class MigrateAggregatorFeedTest extends MigrateDrupalTestBase {
 
   static $modules = array('aggregator');

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemFileTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of filesystem variables to configuration.
+ */
 class MigrateSystemFileTest extends MigrateDrupalTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemImageGdTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of image GD toolkit variables to configuration.
+ */
 class MigrateSystemImageGdTest extends MigrateDrupalTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemImageTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of image toolkit variables to configuration.
+ */
 class MigrateSystemImageTest extends MigrateDrupalTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemMaintenanceTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of system maintenance mode variables to configuration.
+ */
 class MigrateSystemMaintenanceTest extends MigrateDrupalTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemPerformanceTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of system performance variables to configuration.
+ */
 class MigrateSystemPerformanceTest extends MigrateDrupalTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemRssTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of system RSS/feed variables to configuration.
+ */
 class MigrateSystemRssTest extends MigrateDrupalTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemSiteTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of system site variables to configuration.
+ */
 class MigrateSystemSiteTest extends MigrateDrupalTestBase {
 
   /**

core/modules/migrate_drupal/lib/Drupal/migrate_drupal/Tests/d6/MigrateSystemThemeTest.php

@@ -11,6 +11,9 @@ use Drupal\migrate\MigrateMessage;
 use Drupal\migrate\MigrateExecutable;
 use Drupal\migrate_drupal\Tests\MigrateDrupalTestBase;
 
+/**
+ * Tests migration of system theme variables to configuration.
+ */
 class MigrateSystemThemeTest extends MigrateDrupalTestBase {
 
   /**

core/modules/node/lib/Drupal/node/Tests/Views/NodeIntegrationTest.php

@@ -7,6 +7,9 @@
 
 namespace Drupal\node\Tests\Views;
 
+/**
+ * Tests Node module's Views integration.
+ */
 class NodeIntegrationTest extends NodeTestBase {
 
   /**

core/modules/serialization/lib/Drupal/serialization/Tests/EntityResolverTest.php

@@ -6,6 +6,9 @@
 
 namespace Drupal\serialization\Tests;
 
+/**
+ * Tests the entity reference resolver.
+ */
 class EntityResolverTest extends NormalizerTestBase {
 
   /**

core/modules/simpletest/lib/Drupal/simpletest/Tests/MailCaptureTest.php

@@ -9,6 +9,9 @@ namespace Drupal\simpletest\Tests;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests Simpletest email capturing (TestMailCollector) and assertion methods.
+ */
 class MailCaptureTest extends WebTestBase {
   /**
    * Implement getInfo().

core/modules/simpletest/lib/Drupal/simpletest/Tests/SimpleTestTest.php

@@ -10,6 +10,9 @@ namespace Drupal\simpletest\Tests;
 use Drupal\Core\Database\Driver\pgsql\Select;
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests the Simpletest UI test runner and internal browser.
+ */
 class SimpleTestTest extends WebTestBase {
 
   /**

core/modules/system/lib/Drupal/system/Tests/Datetime/DrupalDateTimeTest.php

@@ -10,6 +10,9 @@ namespace Drupal\system\Tests\Datetime;
 use Drupal\simpletest\WebTestBase;
 use Drupal\Core\Datetime\DrupalDateTime;
 
+/**
+ * Tests DrupalDateTime functionality.
+ */
 class DrupalDateTimeTest extends WebTestBase {
 
   /**

core/modules/system/lib/Drupal/system/Tests/Form/FormTest.php

@@ -12,6 +12,9 @@ use Drupal\Component\Utility\String;
 use Drupal\Core\Render\Element;
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests form element validation.
+ */
 class FormTest extends WebTestBase {
 
   /**

core/modules/system/lib/Drupal/system/Tests/Session/SessionTest.php

@@ -9,6 +9,9 @@ namespace Drupal\system\Tests\Session;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests session handling.
+ */
 class SessionTest extends WebTestBase {
 
   /**

core/modules/system/lib/Drupal/system/Tests/System/AdminMetaTagTest.php

@@ -9,6 +9,9 @@ namespace Drupal\system\Tests\System;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests the fingerprinting "Generator" HTML meta tag.
+ */
 class AdminMetaTagTest extends WebTestBase {
   /**
    * Implement getInfo().

core/modules/system/lib/Drupal/system/Tests/System/CronRunTest.php

@@ -9,6 +9,9 @@ namespace Drupal\system\Tests\System;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests cron runs.
+ */
 class CronRunTest extends WebTestBase {
 
   /**

core/modules/system/lib/Drupal/system/Tests/System/DefaultMobileMetaTagsTest.php

@@ -10,6 +10,9 @@ namespace Drupal\system\Tests\System;
 use Drupal\Component\Utility\String;
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests default mobile meta tags on HTML pages.
+ */
 class DefaultMobileMetaTagsTest extends WebTestBase {
   public static function getInfo() {
     return array(

core/modules/system/lib/Drupal/system/Tests/System/PageNotFoundTest.php

@@ -9,6 +9,9 @@ namespace Drupal\system\Tests\System;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests "404 Not found" pages and custom 404 pages.
+ */
 class PageNotFoundTest extends WebTestBase {
   protected $admin_user;
 

core/modules/system/lib/Drupal/system/Tests/System/PageTitleTest.php

@@ -11,6 +11,9 @@ use Drupal\Component\Utility\Xss;
 use Drupal\Core\Utility\Title;
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests HTML output escaping of page title, site name, and slogan.
+ */
 class PageTitleTest extends WebTestBase {
 
   /**

core/modules/user/lib/Drupal/user/Tests/UserAdminSettingsFormTest.php

@@ -10,6 +10,9 @@ namespace Drupal\user\Tests;
 use Drupal\system\Tests\System\SystemConfigFormTestBase;
 use Drupal\user\AccountSettingsForm;
 
+/**
+ * Tests the administrative user settings configuration form.
+ */
 class UserAdminSettingsFormTest extends SystemConfigFormTestBase {
 
   public static function getInfo() {

core/modules/user/lib/Drupal/user/Tests/UserAdminTest.php

@@ -9,6 +9,9 @@ namespace Drupal\user\Tests;
 
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests the user administration UI.
+ */
 class UserAdminTest extends WebTestBase {
 
   /**

core/modules/user/lib/Drupal/user/Tests/UserEditedOwnAccountTest.php

@@ -9,8 +9,8 @@ namespace Drupal\user\Tests;
 
 use Drupal\simpletest\WebTestBase;
 
-/*
- * Test that a user, having editing their own account, can still log in.
+/**
+ * Tests user login after editing own user account.
  */
 class UserEditedOwnAccountTest extends WebTestBase {
 

core/modules/user/lib/Drupal/user/Tests/UserPermissionsTest.php

@@ -10,6 +10,9 @@ namespace Drupal\user\Tests;
 use Drupal\simpletest\WebTestBase;
 use Drupal\user\RoleStorage;
 
+/**
+ * Tests the user role permission UI.
+ */
 class UserPermissionsTest extends WebTestBase {
   protected $admin_user;
   protected $rid;

core/modules/user/lib/Drupal/user/Tests/UserRegistrationTest.php

@@ -11,6 +11,9 @@ use Drupal\Core\Field\FieldDefinitionInterface;
 use Drupal\Core\Language\Language;
 use Drupal\simpletest\WebTestBase;
 
+/**
+ * Tests user registration.
+ */
 class UserRegistrationTest extends WebTestBase {
 
   /**

core/modules/views/lib/Drupal/views/Tests/Plugin/StyleTableTest.php

@@ -7,6 +7,9 @@
 
 namespace Drupal\views\Tests\Plugin;
 
+/**
+ * Tests the table style views plugin.
+ */
 class StyleTableTest extends PluginTestBase {
 
   /**

core/modules/views/lib/Drupal/views/Tests/ViewRenderTest.php

@@ -10,6 +10,9 @@ namespace Drupal\views\Tests;
 use Drupal\views\Tests\ViewTestBase;
 use Drupal\views\Views;
 
+/**
+ * Tests general rendering of a view.
+ */
 class ViewRenderTest extends ViewTestBase {
 
   /**

core/modules/views/tests/Drupal/views/Tests/ViewsTest.php

@@ -13,6 +13,9 @@ use Drupal\views\Entity\View;
 use Drupal\views\ViewExecutableFactory;
 use Drupal\Core\DependencyInjection\ContainerBuilder;
 
+/**
+ * @coversDefaultClass \Drupal\views\Views
+ */
 class ViewsTest extends UnitTestCase {
 
   public static function getInfo() {
@@ -55,6 +58,8 @@ class ViewsTest extends UnitTestCase {
 
   /**
    * Tests the getView() method.
+   *
+   * @covers ::getView
    */
   public function testGetView() {
     $executable = Views::getView('test_view');

core/modules/views_ui/tests/Drupal/views_ui/Tests/ViewListBuilderTest.php

@@ -14,6 +14,9 @@ use Drupal\views\Entity\View;
 use Drupal\views\ViewExecutableFactory;
 use Drupal\views_ui\ViewListBuilder;
 
+/**
+ * @coversDefaultClass \Drupal\views_ui\ViewListBuilder
+ */
 class ViewListBuilderTest extends UnitTestCase {
 
   public static function getInfo() {
@@ -28,6 +31,7 @@ class ViewListBuilderTest extends UnitTestCase {
    * Tests the listing of displays on a views list builder.
    *
    * @see \Drupal\views_ui\ViewListBuilder::getDisplaysList()
+   * @covers ::buildRow
    */
   public function testBuildRowEntityList() {
     $storage = $this->getMockBuilder('Drupal\Core\Config\Entity\ConfigEntityStorage')