Automattic / jetpack

packages/connection/src/class-manager.php

Doc Comments +3 added lines, -2 removed lines

@@ -272,7 +272,7 @@ 
 	/**
 	 * Verifies the signature of the current request.
 	 *
-	 * @return false|array
+	 * @return boolean
 	 */
 	public function verify_xml_rpc_signature() {
 		if ( is_null( $this->xmlrpc_verification ) ) {
@@ -1134,6 +1134,7 @@ 
 	 * @param String  $action  The action name.
 	 * @param Integer $user_id The user identifier.
 	 * @param Integer $exp     Expiration time in seconds.
+	 * @return string
 	 */
 	public function generate_secrets( $action, $user_id = false, $exp = 600 ) {
 		if ( false === $user_id ) {
@@ -1549,7 +1550,7 @@ 
 	 *
 	 * @param int|false    $user_id   false: Return the Blog Token. int: Return that user's User Token.
 	 * @param string|false $token_key If provided, check that the token matches the provided input.
-	 * @param bool|true    $suppress_errors If true, return a falsy value when the token isn't found; When false, return a descriptive WP_Error when the token isn't found.
+	 * @param boolean    $suppress_errors If true, return a falsy value when the token isn't found; When false, return a descriptive WP_Error when the token isn't found.
 	 *
 	 * @return object|false
 	 */

modules/wordads/class-wordads.php

Doc Comments +2 added lines, -2 removed lines

@@ -118,7 +118,7 @@ 
 	 * Convenience function for grabbing options from params->options
 	 *
 	 * @param  string $option the option to grab.
-	 * @param  mixed  $default (optional).
+	 * @param  boolean  $default (optional).
 	 * @return option or $default if not set
 	 *
 	 * @since 4.5.0
@@ -710,7 +710,7 @@ 
 	/**
 	 * Check the reasons to bail before we attempt to insert ads.
 	 *
-	 * @return true if we should bail (don't insert ads)
+	 * @return boolean if we should bail (don't insert ads)
 	 *
 	 * @since 4.5.0
 	 */

modules/wordads/php/class-wordads-sidebar-widget.php

Doc Comments +1 added lines, -1 removed lines

@@ -47,7 +47,7 @@
 	 * @param array $args Widget args.
 	 * @param array $instance The Widget instance.
 	 *
-	 * @return bool|void
+	 * @return false|null
 	 */
 	public function widget( $args, $instance ) {
 		global $wordads;

class.photon.php

Doc Comments +1 added lines, -2 removed lines

@@ -216,7 +216,6 @@ 
 	/**
 	 * Inject image sizes to Jetpack REST API responses. This wraps the filter_photon_norezise_maybe_inject_sizes function.
 	 *
-	 * @param array $data          Attachment sizes data.
 	 * @param int   $attachment_id Attachment's post ID.
 	 *
 	 * @return array Attachment sizes array.
@@ -1332,7 +1331,7 @@ 
 	 * after ourselves without breaking anyone else's filters.
 	 *
 	 * @internal
-	 * @return true
+	 * @return boolean
 	 */
 	public function override_image_downsize_in_rest_edit_context() {
 		return true;

packages/connection/src/class-error-handler.php

Doc Comments +1 added lines, -1 removed lines

@@ -308,7 +308,7 @@
 	 * @since 8.7.0
 	 *
 	 * @param array|string $data the data to be encoded.
-	 * @return boolean|string The encoded string on success, false on failure
+	 * @return false|string The encoded string on success, false on failure
 	 */
 	public function encrypt_data_to_wpcom( $data ) {
 

packages/connection/legacy/class-jetpack-ixr-client.php

Doc Comments +1 added lines

@@ -50,6 +50,7 @@
 	 * Perform the IXR request.
 	 *
 	 * @param string[] ...$args IXR args.
+	 * @param string $args
 	 *
 	 * @return bool True if request succeeded, false otherwise.
 	 */

packages/connection/legacy/class-jetpack-ixr-clientmulticall.php

Doc Comments +1 added lines

@@ -25,6 +25,7 @@
 	 * The rest of the arguments are the params specified to the method.
 	 *
 	 * @param string[] ...$args IXR args.
+	 * @param string $args
 	 */
 	public function addCall( ...$args ) {
 		$method_name   = array_shift( $args );