Automattic / jetpack

projects/plugins/jetpack/modules/sharedaddy/sharing-sources.php

Doc Comments +19 added lines

@@ -388,6 +388,9 @@ 
 		do_action( 'sharing_bump_stats', array( 'service' => $this, 'post' => $post ) );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	public function js_dialog( $name, $params = array() ) {
 		if ( true !== $this->open_link_in_new ) {
 			return;
@@ -1039,6 +1042,9 @@ 
 	public $icon = '\f204';
 	private $share_type = 'default';
 
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 
@@ -1186,6 +1192,10 @@ 
 class Share_Print extends Sharing_Source {
 	public $shortname = 'print';
 	public $icon = '\f469';
+
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 
@@ -1585,6 +1595,9 @@ 
 		return __( 'Pinterest', 'jetpack' );
 	}
 
+	/**
+	 * @return string
+	 */
 	public function get_image( $post ) {
 		if ( class_exists( 'Jetpack_PostImages' ) ) {
 			$image = Jetpack_PostImages::get_image( $post->ID, array( 'fallback_to_avatars' => true ) );
@@ -1724,6 +1737,9 @@ 
 	public $shortname = 'pocket';
 	public $icon = '\f224';
 
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 
@@ -1839,6 +1855,9 @@ 
 class Jetpack_Share_WhatsApp extends Sharing_Source {
 	public $shortname = 'jetpack-whatsapp';
 
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 	}

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',