Automattic / jetpack

projects/plugins/jetpack/modules/shortcodes/youtube.php

Doc Comments +1 added lines, -1 removed lines

@@ -382,7 +382,7 @@
  *
  * @param array $query_args The query args of the URL.
  *
- * @return array The width and height of the shortcode.
+ * @return integer[] The width and height of the shortcode.
  */
 function jetpack_shortcode_youtube_dimensions( $query_args ) {
 	global $content_width;

projects/plugins/jetpack/modules/sitemaps/sitemap-buffer.php

Doc Comments +1 added lines, -1 removed lines

@@ -263,7 +263,7 @@
 	 * @param DOMElement  $parent (optional) an element to which new children should be added.
 	 * @param DOMDocument $root (optional) the parent document.
 	 *
-	 * @return string|DOMDocument The rendered XML string or an object if root element is specified.
+	 * @return null|DOMNode The rendered XML string or an object if root element is specified.
 	 */
 	protected function array_to_xml_string( $array, $parent = null, $root = null ) {
 		$return_string = false;

projects/plugins/jetpack/modules/sso/class.jetpack-sso-helpers.php

Doc Comments +2 added lines, -2 removed lines

@@ -177,10 +177,10 @@
 	 * @since 4.3.0
 	 * @since 4.6.0 Added public-api.wordpress.com as an allowed redirect
 	 *
-	 * @param array $hosts
+	 * @param string[] $hosts
 	 * @param string $api_base
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	static function allowed_redirect_hosts( $hosts, $api_base = JETPACK__API_BASE ) {
 		if ( empty( $hosts ) ) {

projects/plugins/jetpack/modules/videopress/utility-functions.php

Doc Comments +1 added lines, -1 removed lines

@@ -308,7 +308,7 @@
  *
  * @since 4.4
  * @param string $title
- * @return int|WP_Error
+ * @return string
  */
 function videopress_create_new_media_item( $title, $guid = null ) {
 	$post = array(

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.