Automattic / jetpack

modules/site-icon/jetpack-site-icon.php

Doc Comments +1 added lines, -2 removed lines

@@ -592,7 +592,7 @@ 
 	 *
 	 * @param $id
 	 *
-	 * @return mixed
+	 * @return boolean
 	 */
 	public static function delete_site_icon( $id ) {
 		// We add the filter to make sure that we also delete all the added images
@@ -715,7 +715,6 @@ 
 	 * Save Blavatar files to Media Library
 	 *
 	 * @param  string  	$title
-	 * @param  string  	$filename
 	 * @param  string  	$file_type
 	 * @param  boolean 	$generate_meta
 	 * @return int 		$attactment_id

modules/subscriptions.php

Doc Comments +1 added lines, -1 removed lines

@@ -406,7 +406,7 @@
 	 * Send a synchronous XML-RPC subscribe to blog posts or subscribe to post comments request.
 	 *
 	 * @param string $email
-	 * @param array  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
+	 * @param integer  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
 	 * @param bool   $async    (optional) Should the subscription be performed asynchronously?  Defaults to true.
 	 *
 	 * @return true|Jetpack_Error true on success

modules/theme-tools/site-logo/inc/class-site-logo.php

Doc Comments +1 added lines, -1 removed lines

@@ -258,7 +258,7 @@
 	/**
 	 * Reset the site logo if the current logo is deleted in the media manager.
 	 *
-	 * @param int $site_id
+	 * @param int $post_id
 	 * @uses Site_Logo::remove_site_logo()
 	 */
 	public function reset_on_attachment_delete( $post_id ) {

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-v2/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-v2/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 );

_inc/lib/tracks/class.tracks-client.php

Doc Comments +2 added lines, -1 removed lines

@@ -48,7 +48,7 @@ 
 
 	/**
 	 * record_event
-	 * @param  mixed  $event Event object to send to Tracks. An array will be cast to object. Required.
+	 * @param  Jetpack_Tracks_Event  $event Event object to send to Tracks. An array will be cast to object. Required.
 	 *                       Properties are included directly in the pixel query string after light validation.
 	 * @return mixed         True on success, WP_Error on failure
 	 */
@@ -71,6 +71,7 @@ 
 
 	/**
 	 * Synchronously request the pixel
+	 * @param string $pixel
 	 */
 	static function record_pixel( $pixel ) {
 		// Add the Request Timestamp and URL terminator just before the HTTP request.

_inc/lib/class.media-extractor.php

Doc Comments +1 added lines, -1 removed lines

@@ -74,7 +74,7 @@
 	 * NOTE: If you want IMAGES, call extract( $blog_id, $post_id, ...) which will give you more/better image extraction
 	 * This method will give you an error if you ask for IMAGES.
 	 *
-	 * @param $content The HTML post_content of a post
+	 * @param string $content The HTML post_content of a post
 	 * @param $what_to_extract (int) A mask of things to extract, e.g. Jetpack_Media_Meta_Extractor::IMAGES | Jetpack_Media_Meta_Extractor::MENTIONS
 	 * @param $already_extracted (array) Previously extracted things, e.g. images from extract(), which can be used for x-referencing here
 	 * @returns a structure containing metadata about the embedded things, or empty array if nothing found, or WP_Error on error