Automattic / jetpack

projects/plugins/jetpack/modules/videopress/class.videopress-video.php

Doc Comments +2 added lines, -1 removed lines

@@ -174,6 +174,7 @@ 
 	 * @since 1.3
 	 * @var string $guid VideoPress unique identifier
 	 * @var int $maxwidth maximum requested video width. final width and height are calculated on VideoPress servers based on the aspect ratio of the original video upload.
+	 * @param string $guid
 	 */
 	public function __construct( $guid, $maxwidth = 640 ) {
 		$this->guid = $guid;
@@ -311,7 +312,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 wp_parse_url( esc_url_raw( $url ), PHP_URL_HOST );

projects/plugins/jetpack/modules/widgets/blog-stats.php

Doc Comments +1 added lines, -1 removed lines

@@ -46,7 +46,7 @@
 	 *
 	 * These values are used in new widgets.
 	 *
-	 * @return array Array of default values for the Widget's options
+	 * @return string Array of default values for the Widget's options
 	 */
 	public function defaults() {
 		return array(

projects/plugins/jetpack/modules/widgets/eu-cookie-law.php

Doc Comments +1 added lines, -1 removed lines

@@ -116,7 +116,7 @@
 		 *
 		 * These values are used in new widgets.
 		 *
-		 * @return array Default values for the widget options.
+		 * @return string Default values for the widget options.
 		 */
 		public function defaults() {
 			return array(

projects/plugins/jetpack/modules/widgets/facebook-likebox.php

Doc Comments +6 added lines

@@ -231,6 +231,9 @@ 
 		<?php
 	}
 
+	/**
+	 * @return string
+	 */
 	function get_default_args() {
 		$defaults = array(
 			'href'         => '',
@@ -292,6 +295,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;
 

projects/plugins/jetpack/modules/widgets/flickr.php

Doc Comments +1 added lines, -1 removed lines

@@ -116,7 +116,7 @@
 		 *
 		 * These values are used in new widgets.
 		 *
-		 * @return array Default values for the widget options.
+		 * @return string Default values for the widget options.
 		 */
 		public function defaults() {
 			return array(

projects/plugins/jetpack/modules/widgets/gallery.php

Doc Comments +1 added lines, -1 removed lines

@@ -387,7 +387,7 @@
 	 * These values are used in new widgets as well as when sanitizing input. If a given value is not allowed,
 	 * as defined in allowed_values(), that input is set to the default value defined here.
 	 *
-	 * @return array Array of default values for the Widget's options
+	 * @return string Array of default values for the Widget's options
 	 */
 	public function defaults() {
 		return array(

projects/plugins/jetpack/modules/widgets/goodreads.php

Doc Comments +3 added lines

@@ -90,6 +90,9 @@
 		echo $args['after_widget'];
 	}
 
+	/**
+	 * @param string $user_id
+	 */
 	function goodreads_user_id_exists( $user_id ) {
 		$url      = "https://www.goodreads.com/user/show/$user_id/";
 		$response = wp_remote_head(

projects/plugins/jetpack/modules/widgets/rsslinks-widget.php

Doc Comments +4 added lines, -1 removed lines

@@ -62,7 +62,7 @@ 
 	 * Return an associative array of default values
 	 * These values are used in new widgets as well as when sanitizing input.
 	 *
-	 * @return array Array of default values for the Widget's options
+	 * @return string Array of default values for the Widget's options
 	 */
 	function defaults() {
 		return array(
@@ -172,6 +172,9 @@ 
 		echo '</select></label></p></div>';
 	}
 
+	/**
+	 * @param string $type
+	 */
 	function _rss_link( $type, $args ) {
 		if ( 'posts' == $type ) {
 			$type_text = __( 'Posts', 'jetpack' );

projects/packages/sync/src/interface-replicastore.php

Doc Comments +30 added lines

@@ -20,6 +20,7 @@ 
 	 * Empty and reset the replicastore.
 	 *
 	 * @access public
+	 * @return void
 	 */
 	public function reset();
 
@@ -29,6 +30,7 @@ 
 	 * @access public
 	 *
 	 * @param array $config Full sync configuration for this sync module.
+	 * @return void
 	 */
 	public function full_sync_start( $config );
 
@@ -38,6 +40,7 @@ 
 	 * @access public
 	 *
 	 * @param string $checksum Deprecated since 7.3.0.
+	 * @return void
 	 */
 	public function full_sync_end( $checksum );
 
@@ -51,6 +54,7 @@ 
 	 * @param string $status Post status.
 	 * @param int    $min_id Minimum post ID.
 	 * @param int    $max_id Maximum post ID.
+	 * @return integer
 	 */
 	public function post_count( $status = null, $min_id = null, $max_id = null );
 
@@ -81,6 +85,7 @@ 
 	 *
 	 * @param \WP_Post $post   Post object.
 	 * @param bool     $silent Whether to perform a silent action.
+	 * @return void
 	 */
 	public function upsert_post( $post, $silent = false );
 
@@ -90,6 +95,7 @@ 
 	 * @access public
 	 *
 	 * @param int $post_id Post ID.
+	 * @return void
 	 */
 	public function delete_post( $post_id );
 
@@ -121,6 +127,7 @@ 
 	 * @param string $status Comment status.
 	 * @param int    $min_id Minimum comment ID.
 	 * @param int    $max_id Maximum comment ID.
+	 * @return integer
 	 */
 	public function comment_count( $status = null, $min_id = null, $max_id = null );
 
@@ -150,6 +157,7 @@ 
 	 * @access public
 	 *
 	 * @param \WP_Comment $comment Comment object.
+	 * @return void
 	 */
 	public function upsert_comment( $comment );
 
@@ -159,6 +167,7 @@ 
 	 * @access public
 	 *
 	 * @param int $comment_id Comment ID.
+	 * @return void
 	 */
 	public function trash_comment( $comment_id );
 
@@ -168,6 +177,7 @@ 
 	 * @access public
 	 *
 	 * @param int $comment_id Comment ID.
+	 * @return void
 	 */
 	public function spam_comment( $comment_id );
 
@@ -177,6 +187,7 @@ 
 	 * @access public
 	 *
 	 * @param int $comment_id Comment ID.
+	 * @return void
 	 */
 	public function delete_comment( $comment_id );
 
@@ -187,6 +198,7 @@ 
 	 *
 	 * @param int   $post_id  Post ID.
 	 * @param array $statuses Post statuses.
+	 * @return void
 	 */
 	public function trashed_post_comments( $post_id, $statuses );
 
@@ -196,6 +208,7 @@ 
 	 * @access public
 	 *
 	 * @param int $post_id Post ID.
+	 * @return void
 	 */
 	public function untrashed_post_comments( $post_id );
 
@@ -226,6 +239,7 @@ 
 	 *
 	 * @param string $option Option name.
 	 * @param mixed  $value  Option value.
+	 * @return boolean|null
 	 */
 	public function update_option( $option, $value );
 
@@ -245,6 +259,7 @@ 
 	 * @access public
 	 *
 	 * @param string $option Name of option to remove.
+	 * @return boolean|null
 	 */
 	public function delete_option( $option );
 
@@ -254,6 +269,7 @@ 
 	 * @access public
 	 *
 	 * @param array $theme_info Theme info array.
+	 * @return void
 	 */
 	public function set_theme_info( $theme_info );
 
@@ -288,6 +304,7 @@ 
 	 * @param string $meta_key   Meta key.
 	 * @param mixed  $meta_value Meta value.
 	 * @param int    $meta_id    ID of the meta.
+	 * @return boolean|null
 	 */
 	public function upsert_metadata( $type, $object_id, $meta_key, $meta_value, $meta_id );
 
@@ -299,6 +316,7 @@ 
 	 * @param string $type      Meta type.
 	 * @param int    $object_id ID of the object.
 	 * @param array  $meta_ids  IDs of the meta objects to delete.
+	 * @return false|null
 	 */
 	public function delete_metadata( $type, $object_id, $meta_ids );
 
@@ -310,6 +328,7 @@ 
 	 * @param string $type       Meta type.
 	 * @param array  $object_ids IDs of the objects.
 	 * @param string $meta_key   Meta key.
+	 * @return false|null
 	 */
 	public function delete_batch_metadata( $type, $object_ids, $meta_key );
 
@@ -350,6 +369,7 @@ 
 	 *
 	 * @param string $type    Type of updates to set.
 	 * @param int    $updates Total number of updates.
+	 * @return void
 	 */
 	public function set_updates( $type, $updates );
 
@@ -369,6 +389,7 @@ 
 	 *
 	 * @param string $callable Callable name.
 	 * @param mixed  $value    Callable value.
+	 * @return void
 	 */
 	public function set_callable( $callable, $value );
 
@@ -388,6 +409,7 @@ 
 	 *
 	 * @param string $option Network option name.
 	 * @param mixed  $value  Network option value.
+	 * @return boolean|null
 	 */
 	public function update_site_option( $option, $value );
 
@@ -397,6 +419,7 @@ 
 	 * @access public
 	 *
 	 * @param string $option Name of option to remove.
+	 * @return boolean|null
 	 */
 	public function delete_site_option( $option );
 
@@ -458,6 +481,7 @@ 
 	 * @param string           $taxonomy  The context in which to relate the term to the object.
 	 * @param string|int|array $terms     A single term slug, single term id, or array of either term slugs or ids.
 	 * @param bool             $append    Optional. If false will delete difference of terms. Default false.
+	 * @return void
 	 */
 	public function update_object_terms( $object_id, $taxonomy, $terms, $append );
 
@@ -470,6 +494,7 @@ 
 	 *
 	 * @param int   $object_id ID of the object.
 	 * @param array $tt_ids    Term taxonomy IDs.
+	 * @return boolean|null
 	 */
 	public function delete_object_terms( $object_id, $tt_ids );
 
@@ -477,6 +502,7 @@ 
 	 * Retrieve the number of users.
 	 *
 	 * @access public
+	 * @return null|integer
 	 */
 	public function user_count();
 
@@ -495,6 +521,7 @@ 
 	 * @access public
 	 *
 	 * @param \WP_User $user User object.
+	 * @return void
 	 */
 	public function upsert_user( $user );
 
@@ -504,6 +531,7 @@ 
 	 * @access public
 	 *
 	 * @param int $user_id User ID.
+	 * @return void
 	 */
 	public function delete_user( $user_id );
 
@@ -514,6 +542,7 @@ 
 	 *
 	 * @param int    $user_id User ID.
 	 * @param string $locale  The user locale.
+	 * @return void
 	 */
 	public function upsert_user_locale( $user_id, $locale );
 
@@ -523,6 +552,7 @@ 
 	 * @access public
 	 *
 	 * @param int $user_id User ID.
+	 * @return void
 	 */
 	public function delete_user_locale( $user_id );