Automattic / jetpack

class.jetpack-post-images.php

Doc Comments +2 added lines, -2 removed lines

@@ -162,6 +162,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();
@@ -656,7 +657,6 @@ 
 	 * resized and cropped image.
 	 *
 	 * @param  string $src
-	 * @param  int    $dimension
 	 * @return string            Transformed image URL
 	 */
 	static function fit_image_url( $src, $width, $height ) {
@@ -703,7 +703,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.
 	 * }

modules/carousel/jetpack-carousel.php

Doc Comments +12 added lines

@@ -135,6 +135,9 @@ 
 		exit;
 	}
 
+	/**
+	 * @param string $version
+	 */
 	function asset_version( $version ) {
 		/**
 		 * Filter the version string used when enqueuing Carousel assets.
@@ -508,6 +511,9 @@ 
 		return $attr;
 	}
 
+	/**
+	 * @param string $html
+	 */
 	function add_data_to_container( $html ) {
 		global $post;
 		if ( Jetpack_AMP_Support::is_amp_request() ) {
@@ -751,6 +757,9 @@ 
 		return ( 1 == $value ) ? 1 : 0;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function settings_checkbox( $name, $label_text, $extra_text = '', $default_to_checked = true ) {
 		if ( empty( $name ) ) {
 			return;
@@ -766,6 +775,9 @@ 
 		echo '</fieldset>';
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function settings_select( $name, $values, $extra_text = '' ) {
 		if ( empty( $name ) || ! is_array( $values ) || empty( $values ) ) {
 			return;

modules/publicize/ui.php

Doc Comments +7 added lines, -1 removed lines

@@ -346,6 +346,9 @@ 
 		</div><?php
 	}
 
+	/**
+	 * @param string $service_name
+	 */
 	public static function options_page_other( $service_name ) {
 		// Nonce check
 		check_admin_referer( "options_page_{$service_name}_" . $_REQUEST['connection'] );
@@ -769,7 +772,7 @@ 
 	 *
 	 * @param array $connections_data
 	 *
-	 * @return array {
+	 * @return string {
 	 *     Array of content for generating connection form.
 	 *
 	 *     @type string HTML content of form
@@ -872,6 +875,9 @@ 
 		return ob_get_clean();
 	}
 
+	/**
+	 * @return string
+	 */
 	private function google_plus_shut_down_notice() {
 		return wp_kses(
 			sprintf(