Issue #1431658 by Albert Volkman, xjm, kid_icarus, ChinggizKhan, rgristroph,...

Issue #1431658 by Albert Volkman, xjm, kid_icarus, ChinggizKhan, rgristroph, connork: Massive API docs cleanup for system tests

core/modules/action/lib/Drupal/action/Tests/ConfigurationTest.php

@@ -30,8 +30,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test the configuration of advanced actions through the administration
-   * interface.
+   * Tests configuration of advanced actions through administration interface.
    */
   function testActionConfiguration() {
     // Create a user with permission to view the actions administration pages.

core/modules/action/lib/Drupal/action/Tests/LoopTest.php

@@ -10,7 +10,7 @@
 use Drupal\simpletest\WebTestBase;
 
 /**
- * Test actions executing in a potential loop, and make sure they abort properly.
+ * Tests aborting of actions executing in a potential loop.
  */
 class LoopTest extends WebTestBase {
 
@@ -32,7 +32,7 @@ public static function getInfo() {
   }
 
   /**
-   * Set up a loop with 3 - 12 recursions, and see if it aborts properly.
+   * Sets up a loop with 3 - 12 recursions, and sees if it aborts properly.
    */
   function testActionLoop() {
     $user = $this->drupalCreateUser(array('administer actions'));
@@ -55,7 +55,9 @@ function testActionLoop() {
   }
 
   /**
-   * Create an infinite loop by causing a watchdog message to be set,
+   * Loops watchdog messages up to actions_max_stack times.
+   *
+   * Creates an infinite loop by causing a watchdog message to be set,
    * which causes the actions to be triggered again, up to action_max_stack
    * times.
    */

core/modules/system/lib/Drupal/system/Tests/Ajax/AjaxTestBase.php

@@ -22,7 +22,7 @@ abstract class AjaxTestBase extends WebTestBase {
   public static $modules = array('ajax_test', 'ajax_forms_test');
 
   /**
-   * Assert that a command with the required properties exists within the array of Ajax commands returned by the server.
+   * Asserts the array of Ajax commands contains the searched command.
    *
    * The Ajax framework, via the ajax_render() function, returns an array of
    * commands. This array sometimes includes commands automatically provided by

core/modules/system/lib/Drupal/system/Tests/Ajax/CommandsTest.php

@@ -20,7 +20,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test the various Ajax Commands.
+   * Tests the various Ajax Commands.
    */
   function testAjaxCommands() {
     $form_path = 'ajax_forms_test_ajax_commands_form';

core/modules/system/lib/Drupal/system/Tests/Ajax/ElementValidationTest.php

@@ -8,7 +8,7 @@
 namespace Drupal\system\Tests\Ajax;
 
 /**
- * Miscellaneous Ajax tests using ajax_test module.
+ * Tests using ajax_test module.
  */
 class ElementValidationTest extends AjaxTestBase {
   public static function getInfo() {
@@ -20,7 +20,7 @@ public static function getInfo() {
   }
 
   /**
-   * Try to post an Ajax change to a form that has a validated element.
+   * Tries to post an Ajax change to a form that has a validated element.
    *
    * The drivertext field is Ajax-enabled. An additional field is not, but
    * is set to be a required field. In this test the required field is not

core/modules/system/lib/Drupal/system/Tests/Ajax/FormValuesTest.php

@@ -8,7 +8,7 @@
 namespace Drupal\system\Tests\Ajax;
 
 /**
- * Test that $form_state['values'] is properly delivered to $ajax['callback'].
+ * Tests that $form_state['values'] is properly delivered to $ajax['callback'].
  */
 class FormValuesTest extends AjaxTestBase {
   public static function getInfo() {
@@ -27,7 +27,7 @@ function setUp() {
   }
 
   /**
-   * Create a simple form, then POST to system/ajax to change to it.
+   * Submits forms with select and checkbox elements via AJAX.
    */
   function testSimpleAjaxFormValue() {
     // Verify form values of a select element.

core/modules/system/lib/Drupal/system/Tests/Ajax/FrameworkTest.php

@@ -20,7 +20,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test that ajax_render() returns JavaScript settings generated during the page request.
+   * Ensures ajax_render() returns JavaScript settings from the page request.
    *
    * @todo Add tests to ensure that ajax_render() returns commands for new CSS
    *   and JavaScript files to be loaded by the page. See
@@ -45,7 +45,7 @@ function testAJAXRender() {
   }
 
   /**
-   * Test behavior of ajax_render_error().
+   * Tests behavior of ajax_render_error().
    */
   function testAJAXRenderError() {
     // Verify default error message.
@@ -69,7 +69,7 @@ function testAJAXRenderError() {
   }
 
   /**
-   * Test that new JavaScript and CSS files added during an AJAX request are returned.
+   * Tests that new JavaScript and CSS files are returned on an AJAX request.
    */
   function testLazyLoad() {
     $expected = array(

core/modules/system/lib/Drupal/system/Tests/Ajax/MultiFormTest.php

@@ -53,7 +53,7 @@ function setUp() {
   }
 
   /**
-   * Test that a page with the 'page_node_form' included twice works correctly.
+   * Tests that pages with the 'page_node_form' included twice works correctly.
    */
   function testMultiForm() {
     // HTML IDs for elements within the field are potentially modified with

core/modules/system/lib/Drupal/system/Tests/Batch/PercentagesUnitTest.php

@@ -81,7 +81,7 @@ function setUp() {
   }
 
   /**
-   * Test the _batch_api_percentage() function.
+   * Tests the _batch_api_percentage() function.
    */
   function testBatchPercentages() {
     foreach ($this->testCases as $expected_result => $arguments) {

core/modules/system/lib/Drupal/system/Tests/Batch/ProcessingTest.php

@@ -30,7 +30,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test batches triggered outside of form submission.
+   * Tests batches triggered outside of form submission.
    */
   function testBatchNoForm() {
     // Displaying the page triggers batch 1.
@@ -41,7 +41,7 @@ function testBatchNoForm() {
   }
 
   /**
-   * Test batches defined in a form submit handler.
+   * Tests batches defined in a form submit handler.
    */
   function testBatchForm() {
     // Batch 0: no operation.
@@ -80,7 +80,7 @@ function testBatchForm() {
   }
 
   /**
-   * Test batches defined in a multistep form.
+   * Tests batches defined in a multistep form.
    */
   function testBatchFormMultistep() {
     $this->drupalGet('batch-test/multistep');
@@ -100,7 +100,7 @@ function testBatchFormMultistep() {
   }
 
   /**
-   * Test batches defined in different submit handlers on the same form.
+   * Tests batches defined in different submit handlers on the same form.
    */
   function testBatchFormMultipleBatches() {
     // Batches 1, 2 and 3 are triggered in sequence by different submit
@@ -117,7 +117,7 @@ function testBatchFormMultipleBatches() {
   }
 
   /**
-   * Test batches defined in a programmatically submitted form.
+   * Tests batches defined in a programmatically submitted form.
    *
    * Same as above, but the form is submitted through drupal_form_execute().
    */
@@ -135,7 +135,7 @@ function testBatchFormProgrammatic() {
   }
 
   /**
-   * Test that drupal_form_submit() can run within a batch operation.
+   * Tests that drupal_form_submit() can run within a batch operation.
    */
   function testDrupalFormSubmitInBatch() {
     // Displaying the page triggers a batch that programmatically submits a
@@ -146,8 +146,9 @@ function testDrupalFormSubmitInBatch() {
   }
 
   /**
-   * Test batches that return $context['finished'] > 1 do in fact complete.
-   * See http://drupal.org/node/600836
+   * Tests batches that return $context['finished'] > 1 do in fact complete.
+   *
+   * @see http://drupal.org/node/600836
    */
   function testBatchLargePercentage() {
     // Displaying the page triggers batch 5.
@@ -159,7 +160,7 @@ function testBatchLargePercentage() {
 
 
   /**
-   * Will trigger a pass if the texts were found in order in the raw content.
+   * Triggers a pass if the texts were found in order in the raw content.
    *
    * @param $texts
    *   Array of raw strings to look for .
@@ -174,7 +175,7 @@ function assertBatchMessages($texts, $message) {
   }
 
   /**
-   * Helper function: return expected execution stacks for the test batches.
+   * Returns expected execution stacks for the test batches.
    */
   function _resultStack($id, $value = 0) {
     $stack = array();
@@ -241,7 +242,7 @@ function _resultStack($id, $value = 0) {
   }
 
   /**
-   * Helper function: return expected result messages for the test batches.
+   * Returns expected result messages for the test batches.
    */
   function _resultMessages($id) {
     $messages = array();

core/modules/system/lib/Drupal/system/Tests/Bootstrap/GetFilenameUnitTest.php

@@ -23,7 +23,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test that drupal_get_filename() works correctly when the file is not found in the database.
+   * Tests that drupal_get_filename() works when the file is not in database.
    */
   function testDrupalGetFilename() {
     // Reset the static cache so we can test the "db is not active" code of

core/modules/system/lib/Drupal/system/Tests/Bootstrap/HookBootExitTest.php

@@ -30,7 +30,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test calling of hook_boot() and hook_exit().
+   * Tests calling of hook_boot() and hook_exit().
    */
   function testHookBootExit() {
     // Test with cache disabled. Boot and exit should always fire.

core/modules/system/lib/Drupal/system/Tests/Bootstrap/IpAddressTest.php

@@ -48,7 +48,7 @@ function tearDown() {
   }
 
   /**
-   * test IP Address and hostname
+   * Tests IP address and hostname.
    */
   function testIPAddressHost() {
     // Test the normal IP address.

core/modules/system/lib/Drupal/system/Tests/Bootstrap/MiscUnitTest.php

@@ -23,7 +23,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test miscellaneous functions in bootstrap.inc.
+   * Tests miscellaneous functions in bootstrap.inc.
    */
   function testMisc() {
     // Test drupal_array_merge_deep().

core/modules/system/lib/Drupal/system/Tests/Bootstrap/OverrideServerVariablesUnitTest.php

@@ -22,7 +22,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test providing a direct URL to to drupal_override_server_variables().
+   * Tests providing a direct URL to to drupal_override_server_variables().
    */
   function testDrupalOverrideServerVariablesProvidedURL() {
     $tests = array(

core/modules/system/lib/Drupal/system/Tests/Bootstrap/PageCacheTest.php

@@ -39,7 +39,7 @@ function setUp() {
   }
 
   /**
-   * Test support for requests containing If-Modified-Since and If-None-Match headers.
+   * Tests support of requests with If-Modified-Since and If-None-Match headers.
    */
   function testConditionalRequests() {
     $config = config('system.performance');
@@ -83,7 +83,7 @@ function testConditionalRequests() {
   }
 
   /**
-   * Test cache headers.
+   * Tests cache headers.
    */
   function testPageCache() {
     $config = config('system.performance');
@@ -125,7 +125,7 @@ function testPageCache() {
   }
 
   /**
-   * Test page compression.
+   * Tests page compression.
    *
    * The test should pass even if zlib.output_compression is enabled in php.ini,
    * .htaccess or similar, or if compression is done outside PHP, e.g. by the

core/modules/system/lib/Drupal/system/Tests/Bootstrap/ResettableStaticUnitTest.php

@@ -23,7 +23,9 @@ public static function getInfo() {
   }
 
   /**
-   * Test that a variable reference returned by drupal_static() gets reset when
+   * Tests drupal_static() function.
+   *
+   * Tests that a variable reference returned by drupal_static() gets reset when
    * drupal_static_reset() is called.
    */
   function testDrupalStatic() {

core/modules/system/lib/Drupal/system/Tests/Bootstrap/TimerUnitTest.php

@@ -23,9 +23,7 @@ public static function getInfo() {
   }
 
   /**
-   * Test timer_read() to ensure it properly accumulates time when the timer
-   * started and stopped multiple times.
-   * @return
+   * Tests timer_read() time accumulation accuracy across multiple restarts.
    */
   function testTimer() {
     timer_start('test');

core/modules/system/lib/Drupal/system/Tests/Bootstrap/VariableTest.php

@@ -30,7 +30,7 @@ public static function getInfo() {
   }
 
   /**
-   * testVariable
+   * Tests variables then deletes them.
    */
   function testVariable() {
     // Setting and retrieving values.

core/modules/system/lib/Drupal/system/Tests/Cache/CacheTestBase.php

@@ -19,7 +19,7 @@ abstract class CacheTestBase extends WebTestBase {
   protected $default_value = 'CacheTest';
 
   /**
-   * Check whether or not a cache entry exists.
+   * Checks whether or not a cache entry exists.
    *
    * @param $cid
    *   The cache id.
@@ -89,7 +89,8 @@ function assertCacheRemoved($message, $cid = NULL, $bin = NULL) {
   }
 
   /**
-   * Perform the general wipe.
+   * Performs a general wipe of the bin.
+   *
    * @param $bin
    *   The bin to perform the wipe on.
    */