Automattic / jetpack

_inc/lib/tracks/client.php

Doc Comments -1 removed lines

@@ -107,7 +107,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

modules/custom-css/custom-css.php

Doc Comments +1 added lines, -1 removed lines

@@ -1404,7 +1404,7 @@
 	/**
 	 * Migration routine for moving safecss from wp_options to wp_posts to support revisions
 	 *
-	 * @return void
+	 * @return false|null
 	 */
 	static function upgrade() {
 		$css = get_option( 'safecss' );

sync/class.jetpack-sync-listener.php

Doc Comments +3 added lines

@@ -107,6 +107,9 @@
 		$this->enqueue_action( current_filter(), func_get_args(), $this->sync_queue );
 	}
 
+	/**
+	 * @param Jetpack_Sync_Queue $queue
+	 */
 	function enqueue_action( $current_filter, $args, $queue ) {
 
 		/**

sync/class.jetpack-sync-sender.php

Doc Comments +6 added lines

@@ -50,6 +50,9 @@ 
 		return (double) get_option( self::NEXT_SYNC_TIME_OPTION_NAME, 0 );
 	}
 
+	/**
+	 * @param integer $time
+	 */
 	public function set_next_sync_time( $time ) {
 		return update_option( self::NEXT_SYNC_TIME_OPTION_NAME, $time, true );
 	}
@@ -81,6 +84,9 @@ 
 		return $full_sync_result || $sync_result;
 	}
 
+	/**
+	 * @param Jetpack_Sync_Queue $queue
+	 */
 	public function do_sync_for_queue( $queue ) {
 
 		do_action( 'jetpack_sync_before_send_queue_' . $queue->id );

sync/class.jetpack-sync-settings.php

Doc Comments +3 added lines

@@ -60,6 +60,9 @@
 		self::set_importing( null );
 	}
 
+	/**
+	 * @param boolean|null $is_importing
+	 */
 	static function set_importing( $is_importing ) {
 		// set to NULL to revert to WP_IMPORTING, the standard behaviour
 		self::$is_importing = $is_importing;

sync/class.jetpack-sync-module-full-sync.php

Doc Comments +6 added lines

@@ -227,6 +227,9 @@ 
 		$listener->get_full_sync_queue()->reset();
 	}
 
+	/**
+	 * @param integer $default
+	 */
 	private function get_status_option( $option, $default = null ) {
 		$prefix = self::STATUS_OPTION_PREFIX;
 
@@ -258,6 +261,9 @@ 
 		$this->queue_items_added( 1 );
 	}
 
+	/**
+	 * @param integer $item_count
+	 */
 	public function queue_items_added( $item_count ) {
 		$this->items_added_since_last_pause += $item_count;
 

modules/sso/class.jetpack-sso-helpers.php

Doc Comments +1 added lines, -1 removed lines

@@ -1283,7 +1283,7 @@
 	 * Returns an array of stock and custom taxonomy query vars
 	 *
 	 * @global $wp_taxonomies
-	 * @return array
+	 * @return string[]
 	 */
 	function get_taxonomy_vars() {
 		global $wp_taxonomies;

_inc/lib/core-api/class.jetpack-core-api-module-endpoints.php

Doc Comments +1 added lines, -1 removed lines

@@ -159,7 +159,7 @@
 	 *
 	 * @since 4.3.0
 	 *
-	 * @return array Array of Jetpack modules.
+	 * @return string Array of Jetpack modules.
 	 */
 	public function get_modules() {
 		require_once( JETPACK__PLUGIN_DIR . 'class.jetpack-admin.php' );

_inc/lib/class.core-rest-api-endpoints.php

Doc Comments +7 added lines, -3 removed lines

@@ -247,6 +247,11 @@ 
 		) );
 	}
 
+	/**
+	 * @param string $path
+	 * @param string $classname
+	 * @param Jetpack_IXR_Client $constructor_arguments
+	 */
 	public static function route( $path, $classname, $method,
 		$constructor_arguments = NULL,
 		$endpoint_arguments = NULL
@@ -876,7 +881,6 @@ 
 	 * @since 4.3.0
 	 *
 	 * @param string $module Module slug. If empty, it's assumed we're updating a module and we'll try to get its slug.
-	 * @param bool $cache Whether to cache the options or return always fresh.
 	 *
 	 * @return array
 	 */
@@ -1753,7 +1757,7 @@ 
 	 *
 	 * @param string $route Regular expression for the endpoint with the module slug to return.
 	 *
-	 * @return array
+	 * @return string
 	 */
 	public static function get_module_requested( $route = '/module/(?P<slug>[a-z\-]+)' ) {
 
@@ -1778,7 +1782,7 @@ 
 	 * @param string      $modules Can be a single module or a list of modules.
 	 * @param null|string $slug    Slug of the module in the first parameter.
 	 *
-	 * @return array
+	 * @return string
 	 */
 	public static function prepare_modules_for_response( $modules = '', $slug = null ) {
 		if ( get_option( 'permalink_structure' ) ) {