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.jetpack-post-sync.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';

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

class.jetpack-sync.php

Doc Comments +12 added lines, -3 removed lines

@@ -70,7 +70,6 @@ 
 
 	/**
 	 * @param string $file __FILE__
-	 * @param string $option, Option name to sync
 	 * @param string $option ...
 	 */
 	static function sync_options( $file, $option /*, $option, ... */ ) {
@@ -81,8 +80,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() ) return;
@@ -301,6 +298,9 @@ 
 		return $this->register( 'post', $id, $settings );
 	}
 
+	/**
+	 * @param string $to_sync
+	 */
 	static function trigger_sync( $to_sync ) {
 		$jetpack = Jetpack::init();
 		if ( ! $jetpack->sync->sync ) {
@@ -387,6 +387,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 ) {
@@ -771,6 +774,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 );
@@ -878,6 +886,7 @@ 
 
 	/**
 	 * Returns default values of Constants
+	 * @param string $constant
 	 */
 	function default_constant( $constant ) {
 		switch( $constant ) {