Automattic / jetpack

projects/packages/sync/src/replicastore/class-table-checksum.php

Doc Comments +2 added lines, -2 removed lines

@@ -224,7 +224,7 @@ 
 	 *
 	 * @param string $table Table name to validate.
 	 *
-	 * @return mixed|string
+	 * @return string
 	 * @throws Exception Throw an exception on validation failure.
 	 */
 	private function validate_table_name( $table ) {
@@ -482,7 +482,7 @@ 
 	 * @param int|null $range_to   The end of the range.
 	 * @param int|null $limit      How many values to return.
 	 *
-	 * @return array|object|void
+	 * @return boolean
 	 * @throws Exception Throws an exception if validation fails on the internal function calls.
 	 */
 	public function get_range_edges( $range_from = null, $range_to = null, $limit = null ) {

projects/packages/tracking/legacy/class-jetpack-tracks-client.php

Doc Comments +1 added lines, -1 removed lines

@@ -52,7 +52,7 @@
 	/**
 	 * Record an event.
 	 *
-	 * @param  mixed $event Event object to send to Tracks. An array will be cast to object. Required.
+	 * @param  Jetpack_Tracks_Event $event Event object to send to Tracks. An array will be cast to object. Required.
 	 *                      Properties are included directly in the pixel query string after light validation.
 	 * @return mixed         True on success, WP_Error on failure
 	 */

projects/packages/tracking/src/class-tracking.php

Doc Comments +2 added lines, -2 removed lines

@@ -119,8 +119,8 @@
 	/**
 	 * Determines whether tracking should be enabled.
 	 *
-	 * @param Automattic\Jetpack\Terms_Of_Service $terms_of_service A Terms_Of_Service object.
-	 * @param Automattic\Jetpack\Status           $status A Status object.
+	 * @param Terms_Of_Service $terms_of_service A Terms_Of_Service object.
+	 * @param Status           $status A Status object.
 	 *
 	 * @return boolean True if tracking should be enabled, else false.
 	 */

projects/plugins/jetpack/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';

projects/plugins/jetpack/3rd-party/qtranslate-x.php

Doc Comments +1 added lines, -1 removed lines

@@ -18,7 +18,7 @@
  * @param string $url_orig Original URL.
  * @param array  $url_info  Pieces of original URL.
  *
- * @return bool
+ * @return false|string
  */
 function jetpack_no_qtranslate_rest_url_redirect( $url_lang, $url_orig, $url_info ) {
 	if ( false !== strpos( $url_info['wp-path'], 'wp-json/jetpack' ) ) {

projects/plugins/jetpack/3rd-party/woocommerce.php

Doc Comments +1 added lines, -1 removed lines

@@ -66,7 +66,7 @@
  * Add a callback for WooCommerce product rendering in infinite scroll.
  *
  * @param array $callbacks Array of render callpacks for IS.
- * @return array
+ * @return string[]
  */
 function jetpack_woocommerce_infinite_scroll_render_callback( $callbacks ) {
 	$callbacks[] = 'jetpack_woocommerce_infinite_scroll_render';

projects/plugins/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(

projects/plugins/jetpack/_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();

projects/plugins/jetpack/_inc/lib/class.color.php

Doc Comments +13 added lines, -1 removed lines

@@ -149,6 +149,9 @@ 
 
 	/**
 	 * Helper function for Jetpack_Color::fromHsl()
+	 * @param double $p
+	 * @param double $q
+	 * @param integer $t
 	 */
 	private function hue2rgb( $p, $q, $t ) {
 		if ( $t < 0 ) $t += 1;
@@ -498,7 +501,7 @@ 
 	 *
 	 * @param Jetpack_Color $color
 	 *
-	 * @return int
+	 * @return double
 	 */
 	public function getDistanceRgbFrom(Jetpack_Color $color)
 	{
@@ -687,6 +690,9 @@ 
 		return $this->incrementLightness( $amount );
 	}
 
+	/**
+	 * @param integer $amount
+	 */
 	public function incrementLightness( $amount ) {
 		$hsl = $this->toHsl();
 		extract( $hsl );
@@ -704,6 +710,9 @@ 
 		return $this->incrementSaturation( - $amount );
 	}
 
+	/**
+	 * @param integer $amount
+	 */
 	public function incrementSaturation( $amount ) {
 		$hsl = $this->toHsl();
 		extract( $hsl );
@@ -744,6 +753,9 @@ 
 		return $this->incrementHue( $incr );
 	}
 
+	/**
+	 * @param integer $amount
+	 */
 	public function incrementHue( $amount ) {
 		$hsl = $this->toHsl();
 		extract( $hsl );