Index: tests/phpunit/includes/abstract-testcase.php
===================================================================
--- tests/phpunit/includes/abstract-testcase.php	(revision 44899)
+++ tests/phpunit/includes/abstract-testcase.php	(working copy)
@@ -46,6 +46,11 @@
 		return $factory;
 	}
 
+	/**
+	 * Retrieves the name of the current called class.
+	 *
+	 * @return string The class name.
+	 */
 	public static function get_called_class() {
 		if ( function_exists( 'get_called_class' ) ) {
 			return get_called_class();
@@ -61,6 +66,11 @@
 		return $backtrace[2]['class'];
 	}
 
+	/**
+	 * Runs the routine before setting up all tests.
+	 *
+	 * @return void
+	 */
 	public static function setUpBeforeClass() {
 		global $wpdb;
 
@@ -82,6 +92,11 @@
 		self::commit_transaction();
 	}
 
+	/**
+	 * Runs the routine after all tests have been ran.
+	 *
+	 * @return void
+	 */
 	public static function tearDownAfterClass() {
 		parent::tearDownAfterClass();
 
@@ -99,6 +114,11 @@
 		self::commit_transaction();
 	}
 
+	/**
+	 * Runs the routine before each test is executed.
+	 *
+	 * @return void
+	 */
 	public function setUp() {
 		set_time_limit( 0 );
 
@@ -138,6 +158,8 @@
 
 	/**
 	 * After a test method runs, reset any state in WordPress the test method might have changed.
+	 *
+	 * @return void
 	 */
 	public function tearDown() {
 		global $wpdb, $wp_query, $wp;
@@ -165,6 +187,11 @@
 		wp_set_current_user( 0 );
 	}
 
+	/**
+	 * Cleans the global scope (e.g the $_GET and $_POST).
+	 *
+	 * @return void
+	 */
 	public function clean_up_global_scope() {
 		$_GET  = array();
 		$_POST = array();
@@ -306,6 +333,11 @@
 		}
 	}
 
+	/**
+	 * Flushes the WordPress cache.
+	 *
+	 * @return void
+	 */
 	public static function flush_cache() {
 		global $wp_object_cache;
 		$wp_object_cache->group_ops      = array();
@@ -341,6 +373,11 @@
 		}
 	}
 
+	/**
+	 * Starts a database transaction.
+	 *
+	 * @return void
+	 */
 	public function start_transaction() {
 		global $wpdb;
 		$wpdb->query( 'SET autocommit = 0;' );
@@ -359,6 +396,13 @@
 		$wpdb->query( 'COMMIT;' );
 	}
 
+	/**
+	 * Replaces the create table statement for a create temporary table statement.
+	 *
+	 * @param string $query The query to replace the statement for.
+	 *
+	 * @return string The altered query.
+	 */
 	public function _create_temporary_tables( $query ) {
 		if ( 'CREATE TABLE' === substr( trim( $query ), 0, 12 ) ) {
 			return substr_replace( trim( $query ), 'CREATE TEMPORARY TABLE', 0, 12 );
@@ -366,6 +410,13 @@
 		return $query;
 	}
 
+	/**
+	 * Replaces the drop table statement for a drop temporary table statement.
+	 *
+	 * @param string $query The query to replace the statement for.
+	 *
+	 * @return string The altered query.
+	 */
 	public function _drop_temporary_tables( $query ) {
 		if ( 'DROP TABLE' === substr( trim( $query ), 0, 10 ) ) {
 			return substr_replace( trim( $query ), 'DROP TEMPORARY TABLE', 0, 10 );
@@ -373,10 +424,24 @@
 		return $query;
 	}
 
+	/**
+	 * Retrieves the die handler.
+	 *
+	 * @param callable $handler The current die handler.
+	 *
+	 * @return callable The test die handler.
+	 */
 	public function get_wp_die_handler( $handler ) {
 		return array( $this, 'wp_die_handler' );
 	}
 
+	/**
+	 * Throws an exception when called.
+	 *
+	 * @param string $message The die message.
+	 *
+	 * @throws WPDieException Exception containing the message.
+	 */
 	public function wp_die_handler( $message ) {
 		if ( ! is_scalar( $message ) ) {
 			$message = '0';
@@ -385,6 +450,11 @@
 		throw new WPDieException( $message );
 	}
 
+	/**
+	 * Sets up the expectations for testing a deprecated call.
+	 *
+	 * @Return void
+	 */
 	public function expectDeprecated() {
 		$annotations = $this->getAnnotations();
 		foreach ( array( 'class', 'method' ) as $depth ) {
@@ -405,6 +475,12 @@
 		add_action( 'doing_it_wrong_trigger_error', '__return_false' );
 	}
 
+	/**
+	 * Handles a deprecated expectation. The docbloc should contain `@expectedDeprecated`
+	 * to trigger this.
+	 *
+	 * @return void
+	 */
 	public function expectedDeprecated() {
 		$errors = array();
 
@@ -493,6 +569,13 @@
 		}
 	}
 
+	/**
+	 * Adds a deprecated function to the list of caught deprecated calles.
+	 *
+	 * @param string $function The deprecated function.
+	 *
+	 * @return void
+	 */
 	public function deprecated_function_run( $function ) {
 		if ( ! in_array( $function, $this->caught_deprecated ) ) {
 			$this->caught_deprecated[] = $function;
@@ -499,6 +582,14 @@
 		}
 	}
 
+	/**
+	 * Adds a function that has been called in a wrong way to the list of
+	 * doing it wrong calls.
+	 *
+	 * @param string $function The function to add.
+	 *
+	 * @return void
+	 */
 	public function doing_it_wrong_run( $function ) {
 		if ( ! in_array( $function, $this->caught_doing_it_wrong ) ) {
 			$this->caught_doing_it_wrong[] = $function;
@@ -505,10 +596,26 @@
 		}
 	}
 
+	/**
+	 * Checks if the given actual value is an instance of WP_Error.
+	 *
+	 * @param mixed  $actual  The actual value to check.
+	 * @param string $message The message to show when test fails.
+	 *
+	 * @return void
+	 */
 	public function assertWPError( $actual, $message = '' ) {
 		$this->assertInstanceOf( 'WP_Error', $actual, $message );
 	}
 
+	/**
+	 * Checks if the given value isn't an instance of WP_Error.
+	 *
+	 * @param mixed  $actual  The actual value to check.
+	 * @param string $message The message to show when test fails.
+	 *
+	 * @return void
+	 */
 	public function assertNotWPError( $actual, $message = '' ) {
 		if ( is_wp_error( $actual ) && '' === $message ) {
 			$message = $actual->get_error_message();
@@ -516,10 +623,27 @@
 		$this->assertNotInstanceOf( 'WP_Error', $actual, $message );
 	}
 
+
+	/**
+	 * Checks if the given actual value is an instance of IXR_Error.
+	 *
+	 * @param mixed  $actual  The actual value to check.
+	 * @param string $message The message to show when test fails.
+	 *
+	 * @return void
+	 */
 	public function assertIXRError( $actual, $message = '' ) {
 		$this->assertInstanceOf( 'IXR_Error', $actual, $message );
 	}
 
+	/**
+	 * Checks if the given value isn't an instance of IXR_Error.
+	 *
+	 * @param mixed  $actual  The actual value to check.
+	 * @param string $message The message to show when test fails.
+	 *
+	 * @return void
+	 */
 	public function assertNotIXRError( $actual, $message = '' ) {
 		if ( $actual instanceof IXR_Error && '' === $message ) {
 			$message = $actual->message;
@@ -527,6 +651,14 @@
 		$this->assertNotInstanceOf( 'IXR_Error', $actual, $message );
 	}
 
+	/**
+	 * Checks if the given fields are present in the given object.
+	 *
+	 * @param object $object The actual object.
+	 * @param array  $fields The fields to check.
+	 *
+	 * @return void
+	 */
 	public function assertEqualFields( $object, $fields ) {
 		foreach ( $fields as $field_name => $field_value ) {
 			if ( $object->$field_name != $field_value ) {
@@ -535,6 +667,14 @@
 		}
 	}
 
+	/**
+	 * Performs an assertion with whitespace being discarded from the expected and actual values.
+	 *
+	 * @param string $expected The expected value.
+	 * @param string $actual   The actual value.
+	 *
+	 * @return void
+	 */
 	public function assertDiscardWhitespace( $expected, $actual ) {
 		$this->assertEquals( preg_replace( '/\s*/', '', $expected ), preg_replace( '/\s*/', '', $actual ) );
 	}
@@ -546,6 +686,8 @@
 	 *
 	 * @param array $expected Expected array.
 	 * @param array $actual   Array to check.
+	 *
+	 * @return void
 	 */
 	public function assertEqualSets( $expected, $actual ) {
 		sort( $expected );
@@ -560,6 +702,8 @@
 	 *
 	 * @param array $expected Expected array.
 	 * @param array $actual   Array to check.
+	 *
+	 * @return void
 	 */
 	public function assertEqualSetsWithIndex( $expected, $actual ) {
 		ksort( $expected );
@@ -573,6 +717,8 @@
 	 * @since 4.8.0
 	 *
 	 * @param array $array Array to check.
+	 *
+	 * @return void
 	 */
 	public function assertNonEmptyMultidimensionalArray( $array ) {
 		$this->assertTrue( is_array( $array ) );
@@ -596,6 +742,8 @@
 	 * @since 3.5.0
 	 *
 	 * @param string $url The URL for the request.
+	 *
+	 * @return void
 	 */
 	public function go_to( $url ) {
 		// note: the WP and WP_Query classes like to silently fetch parameters
@@ -651,6 +799,8 @@
 	 * support this behaviour.
 	 *
 	 * @since 3.5.0
+	 *
+	 * @return void
 	 */
 	protected function checkRequirements() {
 		parent::checkRequirements();
@@ -701,7 +851,9 @@
 	 *
 	 * @since 3.5.0
 	 *
-	 * @param int $ticket_id Ticket number.
+	 * @param int $ticket_id Ticket number
+	 *
+	 * @return void
 	 */
 	public function knownWPBug( $ticket_id ) {
 		if ( WP_TESTS_FORCE_KNOWN_BUGS || in_array( $ticket_id, self::$forced_tickets ) ) {
@@ -731,6 +883,8 @@
 	 * @since 3.5.0
 	 *
 	 * @param int $ticket_id Ticket number.
+	 *
+	 * @return void
 	 */
 	public function knownPluginBug( $ticket_id ) {
 		if ( WP_TESTS_FORCE_KNOWN_BUGS || in_array( 'Plugin' . $ticket_id, self::$forced_tickets ) ) {
@@ -747,6 +901,8 @@
 	 * @since 3.5.0
 	 *
 	 * @param int $ticket Ticket number.
+	 *
+	 * @return void
 	 */
 	public static function forceTicket( $ticket ) {
 		self::$forced_tickets[] = $ticket;
@@ -760,7 +916,9 @@
 	 *
 	 * This method defines the constants after including files.
 	 *
-	 * @param Text_Template $template
+	 * @param Text_Template $template The template to prepare.
+	 *
+	 * @return void
 	 */
 	public function prepareTemplate( Text_Template $template ) {
 		$template->setVar( array( 'constants' => '' ) );
@@ -804,6 +962,8 @@
 	 * @since 3.8.0 Moved from `Tests_Query_Conditionals` to `WP_UnitTestCase`.
 	 *
 	 * @param string $prop,... Any number of WP_Query properties that are expected to be true for the current request.
+	 *
+	 * @return void
 	 */
 	public function assertQueryTrue() {
 		global $wp_query;
@@ -871,6 +1031,8 @@
 	 * Does not delete a file if its path is set in the `$ignore_files` property.
 	 *
 	 * @param string $file File path.
+	 *
+	 * @return void
 	 */
 	public function unlink( $file ) {
 		$exists = is_file( $file );
@@ -888,6 +1050,8 @@
 	 * Does not delete files if their paths are set in the `$ignore_files` property.
 	 *
 	 * @param string $path Directory path.
+	 *
+	 * @return void
 	 */
 	public function rmdir( $path ) {
 		$files = $this->files_in_dir( $path );
@@ -906,6 +1070,8 @@
 	 *   `$ignore_files` property.
 	 * - `rmdir()` and its helper methods only delete files that are not listed in the `$ignore_files` property. If
 	 *   called during `tearDown()` in tests, this will only delete files added during the previously run test.
+	 *
+	 * @return void
 	 */
 	public function remove_added_uploads() {
 		$uploads = wp_upload_dir();
@@ -959,6 +1125,8 @@
 	 * @since 4.1.0
 	 *
 	 * @param string $path Path to the directory to scan.
+	 *
+	 * @return void
 	 */
 	public function delete_folders( $path ) {
 		$this->matched_dirs = array();
@@ -982,6 +1150,8 @@
 	 * @since 4.1.0
 	 *
 	 * @param string $dir Path to the directory to scan.
+	 *
+	 * @return void
 	 */
 	public function scandir( $dir ) {
 		foreach ( scandir( $dir ) as $path ) {
@@ -1031,6 +1201,8 @@
 	 * @global WP_Rewrite $wp_rewrite
 	 *
 	 * @param string $structure Optional. Permalink structure to set. Default empty.
+	 *
+	 * @return void
 	 */
 	public function set_permalink_structure( $structure = '' ) {
 		global $wp_rewrite;