Automattic / jetpack

modules/shortcodes/soundcloud.php

Doc Comments +2 added lines, -2 removed lines

@@ -142,7 +142,7 @@ 
 /**
  * Plugin options getter
  *
- * @param  string|array $option  Option name
+ * @param  string $option  Option name
  * @param  mixed        $default Default value
  *
  * @return mixed                   Option value
@@ -169,7 +169,7 @@ 
  *
  * @param  string $url
  *
- * @return boolean
+ * @return integer
  */
 function soundcloud_url_has_tracklist( $url ) {
 	return preg_match( '/^(.+?)\/(sets|groups|playlists)\/(.+?)$/', $url );

class.jetpack-post-images.php

Doc Comments +1 added lines, -1 removed lines

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

modules/widgets/internet-defense-league.php

Doc Comments +3 added lines

@@ -129,6 +129,9 @@
 		echo '<p>' . sprintf( _x( 'Learn more about the %s', 'the Internet Defense League', 'jetpack' ), '<a href="https://www.internetdefenseleague.org/">Internet Defense League</a>' ) . '</p>';
 	}
 
+	/**
+	 * @param string $field_name
+	 */
 	public function select( $field_name, $options, $default = null ) {
 		echo '<select class="widefat" name="' . $this->get_field_name( $field_name ) . '">';
 		foreach ( $options as $option_slug => $option_name ) {

class.jetpack-jitm-config.php

Doc Comments +26 added lines

@@ -7,12 +7,18 @@ 
 
 	private $rule;
 
+	/**
+	 * @param string $key
+	 */
 	static function verify_array( &$array, $key ) {
 		if ( ! isset( $array[ $key ] ) ) {
 			$array[ $key ] = array();
 		}
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function __construct( $name ) {
 		$this->rule            = array();
 		self::$config[ $name ] = &$this->rule;
@@ -30,6 +36,9 @@ 
 		return $this;
 	}
 
+	/**
+	 * @param string $capability
+	 */
 	function user_can( $capability ) {
 		self::verify_array( $this->rule, 'caps' );
 
@@ -46,6 +55,9 @@ 
 		return $this;
 	}
 
+	/**
+	 * @param string $plugin
+	 */
 	function plugin_inactive( $plugin ) {
 		self::verify_array( $this->rule, 'inactive_plugins' );
 
@@ -62,6 +74,9 @@ 
 		return $this;
 	}
 
+	/**
+	 * @param string $screen
+	 */
 	function in_admin( $screen ) {
 		self::verify_array( $this->rule, 'message' );
 		self::verify_array( $this->rule['message'], 'screens' );
@@ -71,6 +86,9 @@ 
 		return $this;
 	}
 
+	/**
+	 * @param string $hook
+	 */
 	function with_CTA( $message, $hook ) {
 		self::verify_array( $this->rule, 'message' );
 
@@ -90,6 +108,10 @@ 
 		return $this;
 	}
 
+	/**
+	 * @param string $group
+	 * @param string $detail
+	 */
 	function track( $group, $detail ) {
 		$this->rule['tracker'] = array(
 			$group,
@@ -99,6 +121,10 @@ 
 		return $this;
 	}
 
+	/**
+	 * @param string $key
+	 * @param integer $expected_value
+	 */
 	function has_query_parameter( $key, $expected_value = null ) {
 		self::verify_array( $this->rule, 'has_query' );