Automattic / jetpack

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

Doc Comments +7 added lines, -2 removed lines

@@ -248,6 +248,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
@@ -1744,7 +1749,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 ) {
 
@@ -1769,7 +1774,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;
 	}

sync/class.jetpack-sync-actions.php

Doc Comments +3 added lines

@@ -321,6 +321,9 @@
 		return self::DEFAULT_SYNC_CRON_INTERVAL;
 	}
 
+	/**
+	 * @param string $hook
+	 */
 	static function maybe_schedule_sync_cron( $schedule, $hook ) {
 		if ( ! $hook ) {
 			return;

sync/class.jetpack-sync-settings.php

Doc Comments +9 added lines

@@ -107,6 +107,9 @@ 
 		self::set_is_sending( 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;
@@ -137,6 +140,9 @@ 
 		return (bool) self::$is_syncing;
 	}
 
+	/**
+	 * @param boolean|null $is_syncing
+	 */
 	static function set_is_syncing( $is_syncing ) {
 		self::$is_syncing = $is_syncing;
 	}
@@ -145,6 +151,9 @@ 
 		return (bool) self::$is_sending;
 	}
 
+	/**
+	 * @param boolean|null $is_sending
+	 */
 	static function set_is_sending( $is_sending ) {
 		self::$is_sending = $is_sending;
 	}

sync/class.jetpack-sync-wp-replicastore.php

Doc Comments +10 added lines

@@ -420,6 +420,10 @@ 
 	}
 
 	// functions
+
+	/**
+	 * @param string $name
+	 */
 	public function get_callable( $name ) {
 		$value = get_option( 'jetpack_' . $name );
 
@@ -688,6 +692,9 @@ 
 		return $histogram;
 	}
 
+	/**
+	 * @param string|null $id_column
+	 */
 	private function table_checksum( $table, $columns, $id_column, $where_sql = '1=1', $min_id = null, $max_id = null, $strip_non_ascii = true ) {
 		global $wpdb;
 
@@ -725,6 +732,9 @@ 
 
 	}
 
+	/**
+	 * @param string $where_sql
+	 */
 	private function meta_count( $table, $where_sql, $min_id, $max_id ) {
 		global $wpdb;
 

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

Doc Comments +9 added lines

@@ -279,6 +279,9 @@ 
 		$listener->get_full_sync_queue()->reset();
 	}
 
+	/**
+	 * @param integer $default
+	 */
 	private function get_status_option( $name, $default = null ) {
 		$prefix = self::STATUS_OPTION_PREFIX;
 
@@ -313,6 +316,9 @@ 
 		return $this->read_option( 'jetpack_sync_full_config' );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private function write_option( $name, $value ) {
 		// we write our own option updating code to bypass filters/caching/etc on set_option/get_option
 		global $wpdb;
@@ -340,6 +346,9 @@ 
 		return $updated_num;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private function read_option( $name, $default = null ) {
 		global $wpdb;
 		$value = $wpdb->get_var( 

modules/protect/transient-cleanup.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' );