Automattic / jetpack

projects/plugins/jetpack/sal/class.json-api-site-jetpack.php

Doc Comments +7 added lines

@@ -165,6 +165,9 @@ 
 		return $this->get_atomic_cloud_site_option( 'launch-status' );
 	}
 
+	/**
+	 * @param string $option
+	 */
 	function get_atomic_cloud_site_option( $option ) {
 		if ( ! jetpack_is_atomic_site() ) {
 			return false;
@@ -247,6 +250,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $role
+	 */
 	function current_user_can( $role ) {
 		return current_user_can( $role );
 	}
@@ -306,6 +312,7 @@ 
 
 	/**
 	 * Post functions
+	 * @param string $context
 	 */
 
 	function wrap_post( $post, $context ) {

projects/plugins/jetpack/tests/php/core-api/wpcom-endpoints/test-class-wpcom-rest-api-v2-endpoint-external-media.php

Doc Comments +1 added lines, -1 removed lines

@@ -383,7 +383,7 @@
 	 * @param string $filename File name.
 	 * @param string $dir      Temp directory. Dafault empty.
 	 *
-	 * @return string|string[]|null
+	 * @return string
 	 */
 	public function get_temp_name( $filename, $dir = '' ) {
 		if ( empty( $dir ) ) {

projects/plugins/jetpack/tests/php/json-api/test-class.json-api-plugins-endpoints.php

Doc Comments +3 added lines

@@ -161,6 +161,9 @@
 		return 'direct';
 	}
 
+	/**
+	 * @param string $dir
+	 */
 	function rmdir( $dir ) {
 		foreach ( scandir( $dir ) as $file ) {
 			if ( is_dir( $file ) )

projects/plugins/jetpack/tests/php/media/test-class.jetpack-media-extractor.php

Doc Comments +3 added lines

@@ -199,6 +199,9 @@
 		$this->assertEquals( $image_list, $images_extracted );
 	}
 
+	/**
+	 * @return integer
+	 */
 	private function add_test_post() {
 		$post_id = $this->factory->post->create( array(
 			'post_author' => '1046316',

projects/plugins/jetpack/tests/php/media/test-class.jetpack-post-images.php

Doc Comments +1 added lines, -1 removed lines

@@ -410,7 +410,7 @@
 	 *
 	 * @since 9.1.0
 	 *
-	 * @param array $story_media A representative array of the media in the story. Each is one of 'image', 'video', or 'videopress'.
+	 * @param string[] $story_media A representative array of the media in the story. Each is one of 'image', 'video', or 'videopress'.
 	 * @param bool  $wpcom_mode  If true, handles VideoPress videos the way WP.com does. Defaults to false.
 	 * @return array $post_info {
 	 * An array of information about our post.

projects/plugins/jetpack/tests/php/modules/publicize/test_class.publicize.php

Doc Comments +3 added lines

@@ -139,6 +139,9 @@
 		unregister_post_type( 'foo' );
 	}
 
+	/**
+	 * @param boolean $should_have_publicized
+	 */
 	function assertPublicized( $should_have_publicized, $post ) {
 		if ( $should_have_publicized ) {
 			$this->assertEquals( $post->ID, $this->publicized_post_id, 'Is not the same post ID' );

projects/plugins/jetpack/tests/php/lib/wpcom-helper-functions.php

Doc Comments +1 added lines

@@ -13,6 +13,7 @@
 
 /**
  * Wrapper around `WP_REST_Request` constructor. Injects a `sites/$blog_id` into endpoint string for WPCOM environment
+ * @param string $path
  */
 function wp_rest_request( $method, $path ) {
 	if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {

projects/plugins/jetpack/_inc/lib/core-api/wpcom-fields/class-wpcom-rest-api-v2-attachment-videopress-data.php

Doc Comments +5 added lines, -5 removed lines

@@ -103,7 +103,7 @@ 
 	 *
 	 * @param object $attachment The attachment object.
 	 *
-	 * @return false|int
+	 * @return boolean
 	 */
 	public function is_video( $attachment ) {
 		return isset( $attachment->post_mime_type ) && wp_startswith( $attachment->post_mime_type, 'video/' );
@@ -113,8 +113,8 @@ 
 	 * Removes the jetpack_videopress field from the response if the
 	 * given attachment is not a video.
 	 *
-	 * @param WP_REST_Response $response Response from the attachment endpoint.
-	 * @param WP_Post          $attachment The original attachment object.
+	 * @param stdClass $response Response from the attachment endpoint.
+	 * @param stdClass          $attachment The original attachment object.
 	 *
 	 * @return mixed
 	 */
@@ -146,7 +146,7 @@ 
 	 * @param mixed           $object Response from the attachment endpoint.
 	 * @param WP_REST_Request $request Request to the attachment endpoint.
 	 *
-	 * @return true
+	 * @return boolean
 	 */
 	public function get_permission_check( $object, $request ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
 		return true;
@@ -160,7 +160,7 @@ 
 	 * @param WP_Post         $object The attachment object.
 	 * @param WP_REST_Request $request Request to the attachment endpoint.
 	 *
-	 * @return true
+	 * @return boolean
 	 */
 	public function update_permission_check( $value, $object, $request ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
 		return true;

projects/packages/autoloader/src/class-php-autoloader.php

Doc Comments +1 added lines, -1 removed lines

@@ -100,7 +100,7 @@
 	 *
 	 * @param string $class_name The name of the class to autoload.
 	 *
-	 * @return bool Indicates whether or not a class file was loaded.
+	 * @return null|boolean Indicates whether or not a class file was loaded.
 	 */
 	public static function load_class( $class_name ) {
 		global $jetpack_autoloader_loader;