Automattic / jetpack

modules/shortcodes/vimeo.php

Doc Comments +1 added lines, -1 removed lines

@@ -44,7 +44,7 @@
  * @param array $attr     The attributes of the shortcode.
  * @param array $old_attr Optional array of attributes from the old shortcode format.
  *
- * @return array Width and height.
+ * @return integer[] Width and height.
  */
 function jetpack_shortcode_get_vimeo_dimensions( $attr, $old_attr = array() ) {
 	global $content_width;

packages/capabilities/src/Capabilities/class-wpfilterrule.php

Doc Comments +4 added lines

@@ -24,6 +24,10 @@
 	private $required_value;
 
 	// phpcs:ignore Squiz.Commenting.FunctionComment.Missing
+
+	/**
+	 * @param string $filter_name
+	 */
 	public function __construct( $filter_name, $required_value, $initial_value = false ) {
 		$this->filter_name    = $filter_name;
 		$this->required_value = $required_value;

packages/capabilities/tests/php/test_Capabilities.php

Doc Comments +13 added lines

@@ -22,12 +22,16 @@ 
 
 	/**
 	 * Utility functions
+	 * @param string $role
 	 */
 	protected function setUserRole( $role ) {
 		$user = wp_get_current_user();
 		$user->set_role( $role );
 	}
 
+	/**
+	 * @param string $cap
+	 */
 	protected function addUserCapability( $cap ) {
 		$user = wp_get_current_user();
 		$user->add_cap( $cap );
@@ -102,6 +106,9 @@ 
 		$this->assertFalse( $capability->check()->granted() );
 	}
 
+	/**
+	 * @param string $product_slug
+	 */
 	private function mockJetpackPlan( $product_slug ) {
 		$this->current_product_slug = $product_slug;
 
@@ -134,6 +141,9 @@ 
 		$this->assertFalse( $capability->check()->granted() );
 	}
 
+	/**
+	 * @param string $supports_slug
+	 */
 	private function mockJetpackPlanSupports( $supports_slug ) {
 		$this->current_supports_slug = $supports_slug;
 
@@ -217,6 +227,9 @@ 
 		$this->assertTrue( $capability->check()->granted() );
 	}
 
+	/**
+	 * @param boolean $is_active
+	 */
 	private function mockJetpackIsActive( $is_active ) {
 		$this->current_is_active = $is_active;
 

class.jetpack-capabilities.php

Doc Comments +1 added lines

@@ -27,6 +27,7 @@
 
 	/**
 	 * @param string slug The slug for the rule being built
+	 * @param string $slug
 	 */
 	static function build( $slug ) {
 		return Capabilities::build( $slug );

packages/capabilities/src/class-capabilities.php

Doc Comments +12 added lines

@@ -24,11 +24,19 @@ 
 	}
 
 	// phpcs:ignore Squiz.Commenting.FunctionComment.Missing
+
+	/**
+	 * @param string $name
+	 */
 	public static function get( $name ) {
 		return self::$capabilities[ $name ];
 	}
 
 	// phpcs:ignore Squiz.Commenting.FunctionComment.Missing
+
+	/**
+	 * @param string $name
+	 */
 	public static function granted( $name ) {
 		return isset( self::$capabilities[ $name ] ) ? self::$capabilities[ $name ]->check()->granted() : false;
 	}
@@ -39,6 +47,10 @@ 
 	}
 
 	// phpcs:ignore Squiz.Commenting.FunctionComment.Missing
+
+	/**
+	 * @param Capabilities\AggregateRule $capability
+	 */
 	public static function register( $capability, $name ) {
 		self::$capabilities[ $name ] = $capability;
 	}