Automattic / jetpack

_inc/class.jetpack-provision.php

Doc Comments +3 added lines

@@ -249,6 +249,9 @@
 		}
 	}
 
+	/**
+	 * @param string $access_token
+	 */
 	private static function verify_token( $access_token ) {
 		$request = array(
 			'headers' => array(

_inc/lib/debugger/class-jetpack-cxn-test-base.php

Doc Comments +1 added lines, -1 removed lines

@@ -199,7 +199,7 @@
 	 * @param string $type  Test type, async or direct. Optional, direct all tests.
 	 * @param string $group Testing group to check status of. Optional, default all tests.
 	 *
-	 * @return true|array True if all tests pass. Array of failed tests.
+	 * @return boolean True if all tests pass. Array of failed tests.
 	 */
 	public function pass( $type = 'all', $group = 'all' ) {
 		$results = $this->raw_results( $type, $group );

class.json-api-endpoints.php

Doc Comments +6 added lines, -1 removed lines

@@ -1540,6 +1540,7 @@ 
 	 * timezone set in the options table for the blog or the GMT offset.
 	 *
 	 * @param datetime string $date_string Date to parse.
+	 * @param string $date_string
 	 *
 	 * @return array( $local_time_string, $gmt_time_string )
 	 */
@@ -1649,6 +1650,10 @@ 
 		do_action( 'restapi_theme_init' );
 	}
 
+	/**
+	 * @param string $from_hook
+	 * @param string $to_hook
+	 */
 	function copy_hooks( $from_hook, $to_hook, $base_paths ) {
 		global $wp_filter;
 		foreach ( $wp_filter as $hook => $actions ) {
@@ -2073,7 +2078,7 @@ 
 	 * Get an array of all valid AMP origins for a blog's siteurl.
 	 *
 	 * @param string $siteurl Origin url of the API request.
-	 * @return array
+	 * @return string[]
 	 */
 	public function get_amp_cache_origins( $siteurl ) {
 		$host = parse_url( $siteurl, PHP_URL_HOST );

_inc/lib/class-jetpack-podcast-helper.php

Doc Comments +1 added lines, -1 removed lines

@@ -58,7 +58,7 @@
 	 * Loads an RSS feed using `fetch_feed`.
 	 *
 	 * @param string $feed        The RSS feed URL to load.
-	 * @return SimplePie|WP_Error The RSS object or error.
+	 * @return string The RSS object or error.
 	 */
 	private static function load_feed( $feed ) {
 		$rss = fetch_feed( esc_url_raw( $feed ) );

modules/stats.php

Doc Comments +4 added lines, -4 removed lines

@@ -290,7 +290,7 @@ 
  * Get Stats Options.
  *
  * @access public
- * @param mixed $option Option.
+ * @param string $option Option.
  * @return mixed|null.
  */
 function stats_get_option( $option ) {
@@ -744,7 +744,7 @@ 
  * Stats Convert Chart URLs.
  *
  * @access public
- * @param mixed $html HTML.
+ * @param string $html HTML.
  * @return string
  */
 function stats_convert_chart_urls( $html ) {
@@ -1414,7 +1414,7 @@ 
  *
  * @access public
  * @param mixed $get Get.
- * @param mixed $url URL.
+ * @param string $url URL.
  * @return void
  */
 function stats_print_wp_remote_error( $get, $url ) {
@@ -1556,7 +1556,7 @@ 
  * Stats get remote CSV.
  *
  * @access public
- * @param mixed $url URL.
+ * @param string $url URL.
  * @return array
  */
 function stats_get_remote_csv( $url ) {

packages/connection/src/class-manager.php

Doc Comments +4 added lines, -3 removed lines

@@ -313,7 +313,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 ) ) {
@@ -1286,6 +1286,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 ) {
@@ -2242,7 +2243,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
 	 */
@@ -2626,7 +2627,7 @@ 
 	 * Fetches a signed token.
 	 *
 	 * @param object $token the token.
-	 * @return WP_Error|string a signed token
+	 * @return string a signed token
 	 */
 	public function get_signed_token( $token ) {
 		if ( ! isset( $token->secret ) || empty( $token->secret ) ) {

packages/connection/tests/php/test_Signature.php

Doc Comments +1 added lines, -1 removed lines

@@ -220,7 +220,7 @@
 	 * Also used by @see self::test_request_port_constants
 	 *
 	 * @param mixed   $http_x_forwarded_port value of $_SERVER[ 'HTTP_X_FORWARDED_PORT' ].
-	 * @param mixed   $server_port value of $_SERVER[ 'SERVER_PORT' ]. Null will unset the value.
+	 * @param string   $server_port value of $_SERVER[ 'SERVER_PORT' ]. Null will unset the value.
 	 * @param string  $expeceted The expected output. Null will unset the value.
 	 * @param boolean $ssl Whether to consider current request using SSL or not.
 	 *

_inc/lib/functions.wp-notify.php

Doc Comments +1 added lines, -1 removed lines

@@ -228,7 +228,7 @@
  *
  * @param string $notify_moderator The value of the moderation_notify option.
  * @param int    $comment_id Comment ID.
- * @return boolean Returns false to shortcircuit the execution of wp_notify_moderator
+ * @return string|false Returns false to shortcircuit the execution of wp_notify_moderator
  */
 function jetpack_notify_moderator( $notify_moderator, $comment_id ) {
 

packages/status/tests/php/test-status.php

Doc Comments +1 added lines, -1 removed lines

@@ -294,7 +294,7 @@
 	/**
 	 * Mock $wpdb->get_var() and make it return a certain value.
 	 *
-	 * @param mixed $return_value  Return value of the function.
+	 * @param integer $return_value  Return value of the function.
 	 *
 	 * PHPUnit\Framework\MockObject\MockObject The mock object.
 	 */