Automattic / jetpack

modules/shortcodes/soundcloud.php

Doc Comments +3 added lines, -3 removed lines

@@ -137,8 +137,8 @@ 
 /**
  * Plugin options getter
  *
- * @param  string|array $option  Option name
- * @param  mixed        $default Default value
+ * @param  string $option  Option name
+ * @param  string        $default Default value
  *
  * @return mixed                   Option value
  */
@@ -164,7 +164,7 @@ 
  *
  * @param  string $url
  *
- * @return boolean
+ * @return integer
  */
 function soundcloud_url_has_tracklist( $url ) {
 	return preg_match( '/^(.+?)\/(sets|groups|playlists)\/(.+?)$/', $url );

class.json-api.php

Doc Comments +13 added lines

@@ -29,6 +29,8 @@ 
 	public $did_output = false;
 
 	/**
+	 * @param string $method
+	 * @param string $post_body
 	 * @return WPCOM_JSON_API instance
 	 */
 	static function init( $method = null, $url = null, $post_body = null, $return_new = false ) {
@@ -333,6 +335,9 @@ 
 		return call_user_func_array( array( $endpoint, 'callback' ), $path_pieces );
 	}
 
+	/**
+	 * @param integer $status_code
+	 */
 	function output_early( $status_code, $response = null, $content_type = 'application/json' ) {
 		$exit = $this->exit;
 		$this->exit = false;
@@ -527,6 +532,9 @@ 
 		return json_encode( $data );
 	}
 
+	/**
+	 * @param string $needle
+	 */
 	function ends_with( $haystack, $needle ) {
 		return $needle === substr( $haystack, -strlen( $needle ) );
 	}
@@ -554,6 +562,10 @@ 
 	}
 
 	// Returns true if the specified blog ID is a restricted blog
+
+	/**
+	 * @param integer $blog_id
+	 */
 	function is_restricted_blog( $blog_id ) {
 		/**
 		 * Filters all REST API access and return a 403 unauthorized response for all Restricted blog IDs.
@@ -617,6 +629,7 @@ 
 	 * The result is always output, never returned.
 	 *
 	 * @param string|null $error_code.  Call with string to start the trapping.  Call with null to stop.
+	 * @param string $error_code
 	 */
 	function trap_wp_die( $error_code = null ) {
 		// Stop trapping

json-endpoints/jetpack/class.jetpack-json-api-get-options-endpoint.php

Doc Comments -2 removed lines

@@ -59,9 +59,7 @@
 	 * Get individual setting
 	 *
 	 * @param  sting $name
-	 * @param  string $type
 	 * @param  string or array $callback
-	 * @param  boolean $is_constant
 	 * @return value of the setting
 	 */
 	static function get( $name ) {

sync/class.jetpack-sync-utils.php

Doc Comments +6 added lines

@@ -2,6 +2,9 @@ 
 
 class Jetpack_Sync_Utils {
 
+	/**
+	 * @param string $check_sum_id
+	 */
 	static function sync( $check_sum_id, $values ) {
 		$current_check_sum = self::get_check_sum( $values );
 		if ( Jetpack_Options::get_option( $check_sum_id ) !== $current_check_sum ) {
@@ -20,6 +23,9 @@ 
 		return crc32( self::get_query_string( $values ) );
 	}
 
+	/**
+	 * @return string
+	 */
 	static function get_query_string( $values ) {
 		return build_query( $values );
 	}

class.jetpack-sync.php

Doc Comments +12 added lines, -2 removed lines

@@ -88,8 +88,6 @@ 
 
 	/**
 	 * @param string $file __FILE__
-	 * @param string $option , Option name to sync
-	 * @param string $option ...
 	 */
 	static function sync_constant( $file, $constant ) {
 		if ( is_network_admin() ) {
@@ -158,6 +156,9 @@ 
 		return true;
 	}
 
+	/**
+	 * @param string $to_sync
+	 */
 	static function trigger_sync( $to_sync ) {
 		$jetpack_sync = Jetpack::init()->sync;
 		if ( ! isset( $jetpack_sync->sync ) && empty( $jetpack_sync->sync ) ) {
@@ -404,6 +405,9 @@ 
 		$this->transition_post_status_action( 'delete', $post->post_status, $post );
 	}
 
+	/**
+	 * @param string $new_status
+	 */
 	function transition_post_status_action( $new_status, $old_status, $post ) {
 		$sync = $this->get_post_sync_operation( $new_status, $old_status, $post, $this->sync_conditions['posts'] );
 		if ( ! $sync ) {
@@ -807,6 +811,11 @@ 
 	/* Options Sync */
 
 	/* Ah... so much simpler than Posts and Comments :) */
+
+	/**
+	 * @param string $file
+	 * @param string $option
+	 */
 	function options( $file, $option /*, $option, ... */ ) {
 		$options = func_get_args();
 		$file    = array_shift( $options );
@@ -915,6 +924,7 @@ 
 
 	/**
 	 * Returns default values of Constants
+	 * @param string $constant
 	 */
 	function default_constant( $constant ) {
 		switch ( $constant ) {

sync/class.jetpack-sync-posts.php

Doc Comments +3 added lines

@@ -132,6 +132,9 @@
 		return self::json_api( self::get_post_api_url( $post_id) );
 	}
 
+	/**
+	 * @param string $url
+	 */
 	static function json_api( $url, $method = 'GET' ) {
 
 		require_once JETPACK__PLUGIN_DIR . 'class.json-api.php';