Automattic / jetpack

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-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' ) ) {

json-endpoints/jetpack/class.jetpack-json-api-sync-endpoint.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-queue.php

Doc Comments +6 added lines

@@ -250,6 +250,9 @@ 
 		return true;
 	}
 
+	/**
+	 * @param Jetpack_Sync_Queue_Buffer $buffer
+	 */
 	function close( $buffer, $ids_to_remove = null ) {
 		$is_valid = $this->validate_checkout( $buffer );
 
@@ -328,6 +331,9 @@ 
 		return get_transient( $this->get_checkout_transient_name() );
 	}
 
+	/**
+	 * @param string $checkout_id
+	 */
 	private function set_checkout_id( $checkout_id ) {
 		return set_transient( $this->get_checkout_transient_name(), $checkout_id, 5 * 60 ); // 5 minute timeout
 	}

sync/class.jetpack-sync-sender.php

Doc Comments +10 added lines

@@ -52,6 +52,9 @@ 
 		return (double) get_option( self::NEXT_SYNC_TIME_OPTION_NAME . '_' . $queue_name, 0 );
 	}
 
+	/**
+	 * @param integer $time
+	 */
 	public function set_next_sync_time( $time, $queue_name ) {
 		return update_option( self::NEXT_SYNC_TIME_OPTION_NAME . '_' . $queue_name, $time, true );
 	}
@@ -64,6 +67,9 @@ 
 		return $this->do_sync_and_set_delays( $this->sync_queue );
 	}
 
+	/**
+	 * @param Jetpack_Sync_Queue $queue
+	 */
 	public function do_sync_and_set_delays( $queue ) {
 		// don't sync if importing
 		if ( defined( 'WP_IMPORTING' ) && WP_IMPORTING ) {
@@ -293,6 +299,10 @@ 
 	}
 
 	// in seconds
+
+	/**
+	 * @param double $seconds
+	 */
 	function set_max_dequeue_time( $seconds ) {
 		$this->max_dequeue_time = $seconds;
 	}