Automattic / 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(

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;
 

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(

modules/widgets/rsslinks-widget.php

Doc Comments +1 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(

packages/sync/src/modules/class-users.php

Doc Comments +4 added lines, -4 removed lines

@@ -205,7 +205,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @param \WP_User $user User object.
+	 * @param \WP_User|null $user User object.
 	 * @return \WP_User Expanded user object.
 	 */
 	public function expand_user( $user ) {
@@ -545,7 +545,7 @@ 
 	 * @access public
 	 *
 	 * @param int $user_id ID of the user.
-	 * @return array Current flags of the user.
+	 * @return string Current flags of the user.
 	 */
 	public function get_flags( $user_id ) {
 		if ( isset( $this->flags[ $user_id ] ) ) {
@@ -636,7 +636,7 @@ 
 	 * @todo Refactor to prepare the SQL query before executing it.
 	 *
 	 * @param array $config Full sync configuration for this sync module.
-	 * @return array Number of items yet to be enqueued.
+	 * @return integer Number of items yet to be enqueued.
 	 */
 	public function estimate_full_sync_actions( $config ) {
 		global $wpdb;
@@ -680,7 +680,7 @@ 
 	 *
 	 * @access public
 	 *
-	 * @return array Full sync actions of this module.
+	 * @return string[] Full sync actions of this module.
 	 */
 	public function get_full_sync_actions() {
 		return array( 'jetpack_full_sync_users' );

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(

_inc/lib/class.core-rest-api-endpoints.php

Doc Comments -1 removed lines

@@ -1264,7 +1264,6 @@
 	 *
 	 * @since 4.3.0
 	 *
-	 * @param WP_REST_Request $request The request sent to the WP REST API.
 	 *
 	 * @return object
 	 */

modules/shortcodes/getty.php

Doc Comments +1 added lines, -1 removed lines

@@ -86,7 +86,7 @@
  *
  * @param string $content Post content.
  *
- * @return mixed
+ * @return string
  */
 function wpcom_shortcodereverse_getty( $content ) {
 	if ( ! is_string( $content ) || false === stripos( $content, '.gettyimages.com/' ) ) {

packages/connection/src/class-utils.php

Doc Comments +1 added lines, -1 removed lines

@@ -45,7 +45,7 @@
 	 * @param int    $user_id The user id.
 	 * @param string $token The user token.
 	 * @param bool   $is_master_user Whether the user is the master user.
-	 * @return bool
+	 * @return boolean|null
 	 */
 	public static function update_user_token( $user_id, $token, $is_master_user ) {
 		// Not designed for concurrent updates.