Automattic / jetpack

modules/videopress/class.videopress-player.php

Doc Comments +1 added lines

@@ -185,6 +185,7 @@
 	 * @since 1.3
 	 * @uses current_user_can() to test if current user has edit_posts capability
 	 * @var WP_Error $error WordPress error
+	 * @param VideoPress_Video $error
 	 * @return string HTML string
 	 */
 	private function error_message( $error ) {

modules/videopress/class.videopress-video.php

Doc Comments +1 added lines, -1 removed lines

@@ -271,7 +271,7 @@
 	 *
 	 * @since 1.2
 	 * @param string $url absolute URL
-	 * @return bool|string host component of the URL, or false if none found
+	 * @return string|false host component of the URL, or false if none found
 	 */
 	public static function hostname( $url ) {
 		return parse_url( esc_url_raw( $url ), PHP_URL_HOST );

modules/videopress/videopress.php

Doc Comments +2 added lines

@@ -147,6 +147,7 @@ 
 	 * Performs a remote XML-RPC query using Jetpack's IXR Client. And also
 	 * appends some useful stuff about this setup to the query.
 	 *
+	 * @param string $method
 	 * @return the Jetpack_IXR_Client object after querying.
 	 */
 	function query( $method, $args = null ) {
@@ -349,6 +350,7 @@ 
 	 *
 	 * Similar to current_user_can, but internal to VideoPress. Returns
 	 * true if the given VideoPress capability is allowed by the given user.
+	 * @param string $cap
 	 */
 	function can( $cap, $user_id = false ) {
 		if ( ! $user_id )

modules/widgets/facebook-likebox.php

Doc Comments +3 added lines

@@ -252,6 +252,9 @@
 		return ( FALSE !== strpos( $url, 'facebook.com' ) ) ? TRUE : FALSE;
 	}
 
+	/**
+	 * @param integer $value
+	 */
 	function normalize_int_value( $value, $default = 0, $max = 0, $min = 0 ) {
 		$value = (int) $value;
 

modules/widgets/goodreads.php

Doc Comments +3 added lines

@@ -89,6 +89,9 @@
 		do_action( 'jetpack_stats_extra', 'widget', 'goodreads' );
 	}
 
+	/**
+	 * @param string $user_id
+	 */
 	function goodreads_user_id_exists( $user_id ) {
 		$url = "http://www.goodreads.com/user/show/$user_id/";
 		$response = wp_remote_head( $url, array( 'httpversion'=>'1.1', 'timeout'=>3, 'redirection'=> 2 ) );

json-endpoints/class.wpcom-json-api-update-post-endpoint.php

Doc Comments +19 added lines

@@ -28,6 +28,11 @@ 
 
 	// /sites/%s/posts/new       -> $blog_id
 	// /sites/%s/posts/%d        -> $blog_id, $post_id
+
+	/**
+	 * @param string $path
+	 * @param integer $post_id
+	 */
 	function write_post( $path, $blog_id, $post_id ) {
 		$new  = $this->api->ends_with( $path, '/new' );
 		$args = $this->query_args();
@@ -621,6 +626,11 @@ 
 	}
 
 	// /sites/%s/posts/%d/delete -> $blog_id, $post_id
+
+	/**
+	 * @param string $path
+	 * @param integer $post_id
+	 */
 	function delete_post( $path, $blog_id, $post_id ) {
 		$post = get_post( $post_id );
 		if ( !$post || is_wp_error( $post ) ) {
@@ -656,6 +666,11 @@ 
 	}
 
 	// /sites/%s/posts/%d/restore -> $blog_id, $post_id
+
+	/**
+	 * @param string $path
+	 * @param integer $post_id
+	 */
 	function restore_post( $path, $blog_id, $post_id ) {
 		$args  = $this->query_args();
 		$post = get_post( $post_id );
@@ -676,6 +691,10 @@ 
 		return $this->get_post_by( 'ID', $post->ID, $args['context'] );
 	}
 
+	/**
+	 * @param boolean $delete_featured_image
+	 * @param string $featured_image
+	 */
 	protected function parse_and_set_featured_image( $post_id, $delete_featured_image, $featured_image ) {
 		if ( $delete_featured_image ) {
 			delete_post_thumbnail( $post_id );

modules/widget-visibility/widget-conditions.php

Doc Comments +3 added lines

@@ -616,6 +616,9 @@
 		return strcasecmp( $a->name, $b->name );
 	}
 
+	/**
+	 * @return string
+	 */
 	public static function maybe_get_split_term( $old_term_id = '', $taxonomy = '' ) {
 		$term_id = $old_term_id;
 

class.jetpack-autoupdate.php

Doc Comments +2 added lines, -2 removed lines

@@ -115,7 +115,7 @@ 
 	/**
 	 * Iterates through expected items ( plugins or themes ) and compares them to actual results.
 	 *
-	 * @param $items 'plugin' or 'theme'
+	 * @param string $items 'plugin' or 'theme'
 	 */
 	function log_items( $items ) {
 		$num_items_updated = 0;
@@ -194,7 +194,7 @@ 
 	 * @param $item Example: 'jetpack/jetpack.php' for type 'plugin' or 'twentyfifteen' for type 'theme'
 	 * @param string $type 'plugin' or 'theme'
 	 *
-	 * @return bool|string
+	 * @return false|string
 	 */
 	private function get_error_message( $item, $type = 'plugin' ) {
 		if ( ! isset( $this->autoupdate_results[ $type ] ) ) {

class.jetpack-sync.php

Doc Comments +8 added lines, -3 removed lines

@@ -64,7 +64,6 @@ 
 
 	/**
 	 * @param string $file __FILE__
-	 * @param string $option, Option name to sync
 	 * @param string $option ...
 	 */
 	static function sync_options( $file, $option /*, $option, ... */ ) {
@@ -75,8 +74,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;
@@ -352,6 +349,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 ) {
@@ -736,6 +736,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 );