Automattic / jetpack

tools/docker/mu-plugins/debug.php

Doc Comments +2 added lines, -2 removed lines

@@ -38,7 +38,7 @@ 
  *
  * A null argument will log the file and line number of the l() call.
  *
- * @param mixed $stuff Information to log.
+ * @param string $stuff Information to log.
  */
 function l( $stuff = null ) {
 	// Do nothing when debugging is off.
@@ -166,7 +166,7 @@ 
  *
  * @param string $name Timer name.
  *
- * @return mixed void or elapsed time.
+ * @return null|double void or elapsed time.
  */
 function e( $name = '' ) {
 	static $times = array();

projects/plugins/jetpack/tests/php/modules/publicize/test_class.publicize.php

Doc Comments +3 added lines

@@ -139,6 +139,9 @@
 		unregister_post_type( 'foo' );
 	}
 
+	/**
+	 * @param boolean $should_have_publicized
+	 */
 	function assertPublicized( $should_have_publicized, $post ) {
 		if ( $should_have_publicized ) {
 			$this->assertEquals( $post->ID, $this->publicized_post_id, 'Is not the same post ID' );

projects/plugins/jetpack/tests/php/sync/server/class.jetpack-sync-test-object-factory.php

Doc Comments +13 added lines

@@ -50,6 +50,9 @@ 
 		'filter'      => 'raw',
 	);
 
+	/**
+	 * @param integer $id
+	 */
 	function post( $id, $props = array() ) {
 
 		$now     = current_time( 'mysql' );
@@ -70,6 +73,9 @@ 
 		return new WP_Post( $post );
 	}
 
+	/**
+	 * @param integer $id
+	 */
 	function comment( $id, $post_id, $props = array() ) {
 		$now     = current_time( 'mysql' );
 		$now_gmt = get_gmt_from_date( $now );
@@ -88,6 +94,10 @@ 
 		return new WP_Comment( $comment );
 	}
 
+	/**
+	 * @param integer $id
+	 * @param string $username
+	 */
 	function user( $id, $username, $props = array() ) {
 		$now = current_time( 'mysql' );
 
@@ -140,6 +150,9 @@ 
 		);
 	}
 
+	/**
+	 * @param integer $id
+	 */
 	function term( $id, $props = array() ) {
 		$term = (object) array_merge(
 			self::$default_term_props,

projects/plugins/jetpack/tests/php/sync/server/class.jetpack-sync-test-replicastore.php

Doc Comments +5 added lines

@@ -706,6 +706,11 @@
 		return $post;
 	}
 
+	/**
+	 * @param string $id_field
+	 * @param integer $min_id
+	 * @param integer $max_id
+	 */
 	private function calculate_checksum( $array, $id_field = null, $min_id = null, $max_id = null, $fields = null ) {
 		$this->checksum_fields[ get_current_blog_id() ] = $fields;
 

projects/plugins/jetpack/tests/php/sync/test_class.jetpack-sync-base.php

Doc Comments +4 added lines

@@ -102,6 +102,10 @@
 	// asserts that two objects are the same if they're both "objectified",
 	// i.e. json_encoded and then json_decoded
 	// this is useful because we json encode everything sent to the server
+
+	/**
+	 * @param string $message
+	 */
 	protected function assertEqualsObject( $object_1, $object_2, $message = null ) {
 		$this->assertEquals( $this->objectify( $object_1 ), $this->objectify( $object_2 ), $message );
 	}

projects/plugins/jetpack/tests/php/sync/test_class.jetpack-sync-callables.php

Doc Comments +8 added lines, -2 removed lines

@@ -149,6 +149,9 @@ 
 		return array( 'test' );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function assertCallableIsSynced( $name, $value ) {
 		$this->assertEqualsObject( $value, $this->server_replica_storage->get_callable( $name ), 'Function ' . $name . ' didn\'t have the expected value of ' . json_encode( $value ) );
 	}
@@ -635,6 +638,9 @@ 
 		$this->assert_sanitized_post_type_default( $sanitized, $label );
 	}
 
+	/**
+	 * @param string $label
+	 */
 	function assert_sanitized_post_type_default( $sanitized, $label ) {
 		$this->assertEquals( $label, $sanitized->name );
 		$this->assertEquals( 'Posts', $sanitized->label );
@@ -1201,7 +1207,7 @@ 
 	/**
 	 * Test getting a hosting provider by a known function
 	 *
-	 * @return bool
+	 * @return boolean|null
 	 */
 	public function test_get_hosting_provider_by_known_function() {
 
@@ -1310,7 +1316,7 @@ 
 /**
  * Create a recursive object.
  *
- * @return object
+ * @return stdClass
  */
 function jetpack_recursive_banana() {
 	$banana        = new stdClass();

projects/plugins/jetpack/tests/php/sync/test_class.jetpack-sync-meta.php

Doc Comments +4 added lines

@@ -219,6 +219,10 @@
 		$this->assertEquals( get_post_meta( $post_id, '_feedback_akismet_values', true ), $meta_key_value );
 	}
 
+	/**
+	 * @param string $value
+	 * @param string $type
+	 */
 	function assertOptionIsSynced( $meta_key, $value, $type, $object_id ) {
 		$this->assertEqualsObject( $value, $this->server_replica_storage->get_metadata( $type, $object_id, $meta_key, true ), 'Synced option doesn\'t match local option.' );
 	}

projects/plugins/jetpack/tests/php/sync/test_class.jetpack-sync-options.php

Doc Comments +3 added lines

@@ -286,6 +286,9 @@
 		$this->assertTrue( in_array( 'foo_option_bar', $whitelist ) );
 	}
 
+	/**
+	 * @param string $option_name
+	 */
 	function assertOptionIsSynced( $option_name, $value ) {
 		$this->assertEqualsObject( $value, $this->server_replica_storage->get_option( $option_name ), 'Option ' . $option_name . ' did\'t have the extected value of ' . json_encode( $value ) );
 	}

projects/plugins/jetpack/tests/php/sync/test_class.jetpack-sync-plugins-updates.php

Doc Comments +3 added lines

@@ -125,6 +125,9 @@
 		remove_filter( 'site_transient_update_plugins' , array( $this, 'set_update_plugin_transient' ) );
 	}
 
+	/**
+	 * @param Silent_Upgrader_Skin $skin
+	 */
 	function update_bulk_plugins( $skin ) {
 		require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
 		require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';