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

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(

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
 	 */

packages/redirect/tests/php/bootstrap.php

Doc Comments +4 added lines

@@ -92,6 +92,10 @@
 	return $ret;
 }
 
+/**
+ * @param string $prefix
+ * @param string $sep
+ */
 function _http_build_query( $data, $prefix = null, $sep = null, $key = '', $urlencode = true ) {
 	$ret = array();
 

3rd-party/class-jetpack-bbpress-rest-api.php

Doc Comments +2 added lines, -2 removed lines

@@ -45,7 +45,7 @@ 
 	 *
 	 * @param array $allowed_post_types Allowed post types.
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public function allow_bbpress_post_types( $allowed_post_types ) {
 		$allowed_post_types[] = 'forum';
@@ -59,7 +59,7 @@ 
 	 *
 	 * @param array $allowed_meta_keys Allowed meta keys.
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public function allow_bbpress_public_metadata( $allowed_meta_keys ) {
 		$allowed_meta_keys[] = '_bbp_forum_id';

_inc/lib/class.jetpack-password-checker.php

Doc Comments +1 added lines, -1 removed lines

@@ -410,7 +410,7 @@
 	 *
 	 * @param Mixed $needle the needle.
 	 * @param array $haystack the haystack.
-	 * @return is the needle not in the haystack?
+	 * @return boolean the needle not in the haystack?
 	 */
 	protected function negative_in_array( $needle, $haystack ) {
 		if ( in_array( $needle, $haystack, true ) ) {

_inc/lib/class-jetpack-instagram-gallery-helper.php

Doc Comments +1 added lines, -1 removed lines

@@ -18,7 +18,7 @@
 	 *
 	 * @param  string $access_token The Instagram access token.
 	 * @param  int    $count        The number of Instagram posts to fetch.
-	 * @return mixed
+	 * @return integer|null
 	 */
 	public static function get_instagram_gallery( $access_token, $count ) {
 		$site_id = self::get_site_id();