Automattic / jetpack

packages/analyzer/src/Declarations/Visitor.php

Doc Comments +3 added lines

@@ -11,6 +11,9 @@
 	private $declarations;
 	private $current_relative_path;
 
+	/**
+	 * @param  $declarations
+	 */
 	public function __construct( $current_relative_path, $declarations ) {
 		$this->current_relative_path = $current_relative_path;
 		$this->declarations          = $declarations;

packages/tracking/src/Tracking.php

Doc Comments +3 added lines, -1 removed lines

@@ -14,6 +14,9 @@ 
 	private $product_name;
 	private $connection;
 
+	/**
+	 * @param Connection\Manager $connection
+	 */
 	function __construct( $product_name = 'jetpack', $connection = null ) {
 		$this->product_name = $product_name;
 		$this->connection   = $connection;
@@ -60,7 +63,6 @@ 
 	/**
 	 * Record an event in Tracks - this is the preferred way to record events from PHP.
 	 *
-	 * @param mixed  $identity username, user_id, or WP_user object
 	 * @param string $event_name The name of the event
 	 * @param array  $properties Custom properties to send with the event
 	 * @param int    $event_timestamp_millis The time in millis since 1970-01-01 00:00:00 when the event occurred

packages/status/tests/php/test_Status.php

Doc Comments +3 added lines, -5 removed lines

@@ -176,7 +176,6 @@ 
 	/**
 	 * Mock a set of filters.
 	 *
-	 * @param array $args Array of filters with their arguments.
 	 * @return phpmock\Mock The mock object.
 	 */
 	protected function mock_filters( $filters = array() ) {
@@ -186,8 +185,7 @@ 
 	/**
 	 * Mock a set of constants.
 	 *
-	 * @param array $args Array of sets with constants and their respective values.
-	 * @return phpmock\Mock The mock object.
+	 * @return phpmock\Mock[] The mock object.
 	 */
 	protected function mock_constants( $constants = array() ) {
 		$prepare_constant = function( $constant ) {
@@ -204,7 +202,7 @@ 
 	 * Mock a global function and make it return a certain value.
 	 *
 	 * @param string $function_name Name of the function.
-	 * @param mixed  $return_value  Return value of the function.
+	 * @param string|boolean  $return_value  Return value of the function.
 	 * @return phpmock\Mock The mock object.
 	 */
 	protected function mock_function( $function_name, $return_value = null ) {
@@ -220,7 +218,7 @@ 
 	/**
 	 * Mock $wpdb->get_var() and make it return a certain value.
 	 *
-	 * @param mixed  $return_value  Return value of the function.
+	 * @param integer  $return_value  Return value of the function.
 	 * @return PHPUnit\Framework\MockObject\MockObject The mock object.
 	 */
 	protected function mock_wpdb_get_var( $return_value = null ) {

packages/sync/src/modules/Module.php

Doc Comments +17 added lines

@@ -42,6 +42,9 @@ 
 		return array();
 	}
 
+	/**
+	 * @param string[] $actions_to_count
+	 */
 	protected function count_actions( $action_names, $actions_to_count ) {
 		return count( array_intersect( $action_names, $actions_to_count ) );
 	}
@@ -58,6 +61,11 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $action_name
+	 * @param string $id_field
+	 * @param string|null $where_sql
+	 */
 	protected function enqueue_all_ids_as_action( $action_name, $table_name, $id_field, $where_sql, $max_items_to_enqueue, $state ) {
 		global $wpdb;
 
@@ -111,6 +119,9 @@ 
 		return $chunks_with_ends;
 	}
 
+	/**
+	 * @param string $meta_type
+	 */
 	protected function get_metadata( $ids, $meta_type, $meta_key_whitelist ) {
 		global $wpdb;
 		$table = _get_meta_table( $meta_type );
@@ -131,12 +142,18 @@ 
 		);
 	}
 
+	/**
+	 * @param string $meta_type
+	 */
 	public function init_listeners_for_meta_type( $meta_type, $callable ) {
 		add_action( "added_{$meta_type}_meta", $callable, 10, 4 );
 		add_action( "updated_{$meta_type}_meta", $callable, 10, 4 );
 		add_action( "deleted_{$meta_type}_meta", $callable, 10, 4 );
 	}
 
+	/**
+	 * @param string $meta_type
+	 */
 	public function init_meta_whitelist_handler( $meta_type, $whitelist_handler ) {
 		add_filter( "jetpack_sync_before_enqueue_added_{$meta_type}_meta", $whitelist_handler );
 		add_filter( "jetpack_sync_before_enqueue_updated_{$meta_type}_meta", $whitelist_handler );

packages/sync/src/modules/Users.php

Doc Comments +3 added lines, -3 removed lines

@@ -183,7 +183,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @param \WP_User $user User object.
+	 * @param \WP_User|null $user User object.
 	 * @return \WP_User Expanded user object.
 	 */
 	public function expand_user( $user ) {
@@ -614,7 +614,7 @@ 
 	 * @todo Refactor to prepare the SQL query before executing it.
 	 *
 	 * @param array $config Full sync configuration for this sync module.
-	 * @return array Number of items yet to be enqueued.
+	 * @return integer Number of items yet to be enqueued.
 	 */
 	public function estimate_full_sync_actions( $config ) {
 		global $wpdb;
@@ -658,7 +658,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @return array Full sync actions of this module.
+	 * @return string[] Full sync actions of this module.
 	 */
 	public function get_full_sync_actions() {
 		return array( 'jetpack_full_sync_users' );