Automattic / jetpack

packages/sync/src/Queue.php

Doc Comments +3 added lines

@@ -346,6 +346,9 @@
 		return false;
 	}
 
+	/**
+	 * @param string $checkout_id
+	 */
 	private function set_checkout_id( $checkout_id ) {
 		global $wpdb;
 

packages/sync/src/Replicastore.php

Doc Comments +14 added lines

@@ -449,6 +449,10 @@ 
 	}
 
 	// functions
+
+	/**
+	 * @param string $name
+	 */
 	public function get_callable( $name ) {
 		$value = get_option( 'jetpack_' . $name );
 
@@ -664,6 +668,10 @@ 
 		}
 	}
 
+	/**
+	 * @param string $object_type
+	 * @param integer $buckets
+	 */
 	function checksum_histogram( $object_type, $buckets, $start_id = null, $end_id = null, $columns = null, $strip_non_ascii = true, $salt = '' ) {
 		global $wpdb;
 
@@ -754,6 +762,9 @@ 
 		return $histogram;
 	}
 
+	/**
+	 * @param string|null $id_column
+	 */
 	private function table_checksum( $table, $columns, $id_column, $where_sql = '1=1', $min_id = null, $max_id = null, $strip_non_ascii = true, $salt = '' ) {
 		global $wpdb;
 
@@ -805,6 +816,9 @@ 
 		return 'sum';
 	}
 
+	/**
+	 * @param string $where_sql
+	 */
 	private function meta_count( $table, $where_sql, $min_id, $max_id ) {
 		global $wpdb;
 

class.jetpack-post-images.php

Doc Comments +5 added lines, -3 removed lines

@@ -13,6 +13,7 @@ 
 class Jetpack_PostImages {
 	/**
 	 * If a slideshow is embedded within a post, then parse out the images involved and return them
+	 * @param integer $post_id
 	 */
 	static function from_slideshow( $post_id, $width = 200, $height = 200 ) {
 		$images = array();
@@ -89,6 +90,7 @@ 
 
 	/**
 	 * If a gallery is detected, then get all the images from it.
+	 * @param integer $post_id
 	 */
 	static function from_gallery( $post_id ) {
 		$images = array();
@@ -162,6 +164,7 @@ 
 	/**
 	 * Get attachment images for a specified post and return them. Also make sure
 	 * their dimensions are at or above a required minimum.
+	 * @param integer $post_id
 	 */
 	static function from_attachment( $post_id, $width = 200, $height = 200 ) {
 		$images = array();
@@ -224,7 +227,7 @@ 
 	 * Check if a Featured Image is set for this post, and return it in a similar
 	 * format to the other images?_from_*() methods.
 	 * @param  int $post_id The post ID to check
-	 * @return Array containing details of the Featured Image, or empty array if none.
+	 * @return integer|null containing details of the Featured Image, or empty array if none.
 	 */
 	static function from_thumbnail( $post_id, $width = 200, $height = 200 ) {
 		$images = array();
@@ -663,7 +666,6 @@ 
 	 * resized and cropped image.
 	 *
 	 * @param  string $src
-	 * @param  int    $dimension
 	 * @return string            Transformed image URL
 	 */
 	static function fit_image_url( $src, $width, $height ) {
@@ -710,7 +712,7 @@ 
 	 *
 	 * @param mixed $html_or_id The HTML string to parse for images, or a post id.
 	 *
-	 * @return array $html_info {
+	 * @return integer $html_info {
 	 * @type string $html     Post content.
 	 * @type string $post_url Post URL.
 	 * }