Automattic / jetpack

modules/shortcodes/class.filter-embedded-html-objects.php

Doc Comments +6 added lines

@@ -112,6 +112,9 @@ 
 		return $html;
 	}
 
+	/**
+	 * @param string $regexp
+	 */
 	public static function regexp_entities( $regexp ) {
 		return preg_replace(
 			'/\[\^&([^\]]+)\]\*\+/',
@@ -150,6 +153,9 @@ 
 		return self::dispatch( $matches );
 	}
 
+	/**
+	 * @param string[] $matches
+	 */
 	static function dispatch( $matches ) {
 		$html  = preg_replace( '%&#0*58;//%', '://', $matches[0] );
 		$attrs = self::get_attrs( $html );

modules/shortcodes/polldaddy.php

Doc Comments +3 added lines

@@ -22,6 +22,9 @@
 			add_action( 'infinite_scroll_render', array( $this, 'polldaddy_shortcode_infinite' ), 11 );
 		}
 
+		/**
+		 * @param string $survey_link
+		 */
 		private function get_async_code( array $settings, $survey_link ) {
 			$embed_src     = 'http://i0.poll.fm/survey.js';
 			$embed_src_ssl = 'https://polldaddy.com/survey.js';

modules/widgets/goodreads.php

Doc Comments +3 added lines

@@ -90,6 +90,9 @@
 		echo $args['after_widget'];
 	}
 
+	/**
+	 * @param string $user_id
+	 */
 	function goodreads_user_id_exists( $user_id ) {
 		$url      = "https://www.goodreads.com/user/show/$user_id/";
 		$response = wp_remote_head(

modules/widgets/simple-payments.php

Doc Comments +3 added lines, -3 removed lines

@@ -276,7 +276,7 @@ 
 		 * Returns the number of decimal places on string representing a price.
 		 *
 		 * @param string $number Price to check.
-		 * @return number number of decimal places.
+		 * @return null|integer number of decimal places.
 		 */
 		private function get_decimal_places( $number ) {
 			$parts = explode( '.', $number );
@@ -377,8 +377,7 @@ 
 		/**
 		 * Gets the latests field value from either the old instance or the new instance.
 		 *
-		 * @param array $mixed Array of values for the new form instance.
-		 * @param array $mixed Array of values for the old form instance.
+		 * @param string $field
 		 * @return mixed $mixed Field value.
 		 */
 		private function get_latest_field_value( $new_instance, $old_instance, $field ) {
@@ -392,6 +391,7 @@ 
 		 * it returns the default values.
 		 *
 		 * @param int Product Post ID.
+		 * @param integer $product_post_id
 		 * @return array $fields Product Fields from the Product Post.
 		 */
 		private function get_product_from_post( $product_post_id ) {

modules/wordads/php/api.php

Doc Comments +4 added lines, -4 removed lines

@@ -68,7 +68,7 @@ 
 	/**
 	 * Returns status of WordAds approval.
 	 *
-	 * @return boolean true if site is WordAds approved
+	 * @return string true if site is WordAds approved
 	 *
 	 * @since 4.5.0
 	 */
@@ -83,7 +83,7 @@ 
 	/**
 	 * Returns status of WordAds active.
 	 *
-	 * @return boolean true if ads are active on site
+	 * @return string true if ads are active on site
 	 *
 	 * @since 4.5.0
 	 */
@@ -98,7 +98,7 @@ 
 	/**
 	 * Returns status of WordAds house ads.
 	 *
-	 * @return boolean true if WP.com house ads should be shown
+	 * @return string true if WP.com house ads should be shown
 	 *
 	 * @since 4.5.0
 	 */
@@ -114,7 +114,7 @@ 
 	/**
 	 * Returns whether or not this site is safe to run ads on.
 	 *
-	 * @return boolean true if ads shown not be shown on this site.
+	 * @return string true if ads shown not be shown on this site.
 	 *
 	 * @since 6.5.0
 	 */

modules/wordads/wordads.php

Doc Comments +2 added lines, -2 removed lines

@@ -49,7 +49,7 @@ 
 	 * Convenience function for grabbing options from params->options
 	 *
 	 * @param  string $option the option to grab
-	 * @param  mixed  $default (optional)
+	 * @param  boolean  $default (optional)
 	 * @return option or $default if not set
 	 *
 	 * @since 4.5.0
@@ -494,7 +494,7 @@ 
 	/**
 	 * Check the reasons to bail before we attempt to insert ads.
 	 *
-	 * @return true if we should bail (don't insert ads)
+	 * @return boolean if we should bail (don't insert ads)
 	 *
 	 * @since 4.5.0
 	 */

modules/after-the-deadline/config-options.php

Doc Comments +9 added lines

@@ -6,6 +6,9 @@ 
 /*
  *   A convienence function to display the HTML for an AtD option
  */
+/**
+ * @param string $name
+ */
 function AtD_print_option( $name, $value, $options ) {
 	// Attribute-safe version of $name
 	$attr_name = sanitize_title( $name ); // Using sanitize_title since there's no comparable function for attributes
@@ -112,6 +115,9 @@ 
 /*
  *  Returns an array of AtD user options specified by $name
  */
+/**
+ * @param string $name
+ */
 function AtD_get_options( $user_id, $name ) {
 	$options_raw = AtD_get_setting( $user_id, $name, 'single' );
 
@@ -130,6 +136,9 @@ 
 /*
  *  Saves set of user options specified by $name from POST data
  */
+/**
+ * @param string $name
+ */
 function AtD_update_options( $user_id, $name ) {
 	/* We should probably run $_POST[name] through an esc_*() function... */
 	if ( isset( $_POST[ $name ] ) && is_array( $_POST[ $name ] ) ) {

modules/carousel/jetpack-carousel.php

Doc Comments +9 added lines

@@ -133,6 +133,9 @@ 
 		exit;
 	}
 
+	/**
+	 * @param string $version
+	 */
 	function asset_version( $version ) {
 		/**
 		 * Filter the version string used when enqueuing Carousel assets.
@@ -707,6 +710,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;
@@ -722,6 +728,9 @@ 
 		echo '</fieldset>';
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function settings_select( $name, $values, $extra_text = '' ) {
 		if ( empty( $name ) || ! is_array( $values ) || empty( $values ) ) {
 			return;

modules/tiled-gallery/tiled-gallery/tiled-gallery-layout.php

Doc Comments +8 added lines

@@ -9,6 +9,11 @@ 
 	public $link;
 	public $grayscale;
 	public $columns;
+
+	/**
+	 * @param boolean $grayscale
+	 * @param integer $columns
+	 */
 	public function __construct( $attachments, $link, $grayscale, $columns ) {
 
 		$this->attachments           = $attachments;
@@ -39,6 +44,9 @@ 
 		return $html;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private function template( $name, $context = null ) {
 		if ( ! in_array( $name, self::$templates ) ) {
 			return;