Automattic / jetpack

modules/protect/blocked-login-page.php

Doc Comments +4 added lines

@@ -35,6 +35,7 @@ 
 	/**
 	 * Singleton implementation
 	 *
+	 * @param string|false $ip_address
 	 * @return object
 	 */
 	public static function instance( $ip_address ) {
@@ -348,6 +349,9 @@ 
 		return $contents;
 	}
 
+	/**
+	 * @param string $message
+	 */
 	function display_page( $title, $message, $back_button = false, $recovery_form = false ) {
 
 		if ( ! headers_sent() ) {

functions.photon.php

Doc Comments +1 added lines, -1 removed lines

@@ -326,7 +326,7 @@
  *
  * @param string  $url The URL to parse.
  * @param integer $component Retrieve specific URL component.
- * @return mixed Result of parse_url
+ * @return string|false Result of parse_url
  */
 function jetpack_photon_parse_url( $url, $component = -1 ) {
 	_deprecated_function( 'jetpack_photon_parse_url', 'jetpack-7.8.0', 'wp_parse_url' );

modules/shortcodes/youtube.php

Doc Comments +2 added lines, -2 removed lines

@@ -378,7 +378,7 @@ 
  *
  * @since 8.0.0
  *
- * @param array $url The parsed URL of the shortcode.
+ * @param string|false $url The parsed URL of the shortcode.
  *
  * @return array|false The query args of the URL, or false.
  */
@@ -452,7 +452,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;

modules/videopress/class.videopress-video.php

Doc Comments +2 added lines, -1 removed lines

@@ -174,6 +174,7 @@ 
 	 * @since 1.3
 	 * @var string $guid VideoPress unique identifier
 	 * @var int $maxwidth maximum requested video width. final width and height are calculated on VideoPress servers based on the aspect ratio of the original video upload.
+	 * @param string $guid
 	 */
 	public function __construct( $guid, $maxwidth = 640 ) {
 		$this->guid = $guid;
@@ -311,7 +312,7 @@ 
 	 *
 	 * @since 1.2
 	 * @param string $url absolute URL
-	 * @return bool|string host component of the URL, or false if none found
+	 * @return string|false host component of the URL, or false if none found
 	 */
 	public static function hostname( $url ) {
 		return wp_parse_url( esc_url_raw( $url ), PHP_URL_HOST );

packages/sync/src/class-replicastore.php

Doc Comments +1 added lines, -1 removed lines

@@ -325,7 +325,7 @@
 	 * @access protected
 	 *
 	 * @param string $status Comment status.
-	 * @return string|bool New comment_approved value, false if the status doesn't affect it.
+	 * @return string|false New comment_approved value, false if the status doesn't affect it.
 	 */
 	protected function comment_status_to_approval_value( $status ) {
 		switch ( (string) $status ) {

modules/shortcodes/instagram.php

Doc Comments +1 added lines, -1 removed lines

@@ -145,7 +145,7 @@
  * @param string $url  URL of the content to be embedded.
  * @param array  $atts Shortcode attributes.
  *
- * @return array $params Array of parameters to be used in Instagram query.
+ * @return string $params Array of parameters to be used in Instagram query.
  */
 function jetpack_instagram_get_allowed_parameters( $url, $atts = array() ) {
 	global $content_width;

extensions/blocks/story/story.php

Doc Comments +1 added lines, -1 removed lines

@@ -217,7 +217,7 @@
  * Render a slide
  *
  * @param array $media  Media information.
- * @param array $index  Index of the slide, first slide will be displayed by default, others hidden.
+ * @param integer $index  Index of the slide, first slide will be displayed by default, others hidden.
  *
  * @return string
  */

modules/widgets/rsslinks-widget.php

Doc Comments +4 added lines, -1 removed lines

@@ -62,7 +62,7 @@ 
 	 * Return an associative array of default values
 	 * These values are used in new widgets as well as when sanitizing input.
 	 *
-	 * @return array Array of default values for the Widget's options
+	 * @return string Array of default values for the Widget's options
 	 */
 	function defaults() {
 		return array(
@@ -172,6 +172,9 @@ 
 		echo '</select></label></p></div>';
 	}
 
+	/**
+	 * @param string $type
+	 */
 	function _rss_link( $type, $args ) {
 		if ( 'posts' == $type ) {
 			$type_text = __( 'Posts', 'jetpack' );

packages/connection/tests/php/test_Signature.php

Doc Comments +1 added lines, -1 removed lines

@@ -220,7 +220,7 @@
 	 * Also used by @see self::test_request_port_constants
 	 *
 	 * @param mixed   $http_x_forwarded_port value of $_SERVER[ 'HTTP_X_FORWARDED_PORT' ].
-	 * @param mixed   $server_port value of $_SERVER[ 'SERVER_PORT' ]. Null will unset the value.
+	 * @param string   $server_port value of $_SERVER[ 'SERVER_PORT' ]. Null will unset the value.
 	 * @param string  $expeceted The expected output. Null will unset the value.
 	 * @param boolean $ssl Whether to consider current request using SSL or not.
 	 *