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/_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 );

projects/plugins/jetpack/_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
 	 */

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

projects/plugins/jetpack/_inc/lib/class.jetpack-search-performance-logger.php

Doc Comments +4 added lines

@@ -62,6 +62,10 @@
 		return $query->is_main_query() && $query->is_search();
 	}
 
+	/**
+	 * @param double $duration
+	 * @param boolean $was_jetpack_search
+	 */
 	private function record_query_time( $duration, $was_jetpack_search ) {
 		$this->stats[] = array( $was_jetpack_search, (int) ( $duration * 1000 ) );
 	}